{
  "info": {
    "_postman_id": "524a1708-7cec-54b4-9a9b-ad414dddd93a",
    "name": "Uzobestgsm API",
    "description": "# Uzobestgsm API\n\nBuy data, airtime, cable TV, electricity, exam pins, recharge pins, internet and bulk SMS from your own website or app.\n\n## Start\n1. Set the collection variable `api_key` to your API key (Uzobestgsm > API docs > My API key). Never share it.\n2. Every request sends `Authorization: Token {{api_key}}` (set on the collection).\n3. Addresses: `{{base_url}}` + the path. With or without the final slash.\n\nVTU websites that connect with a website address and an API key: enter our address and your key, nothing else is needed.\n\n## Statuses\n- **processing**: We are still waiting for the network. Wait for the webhook, or check again after a minute.\n- **successful**: Delivered. The money stays charged.\n- **failed**: Not delivered. The money is back in your wallet (see balance_after in the webhook).\n\n## HTTP answers\n- **200 / 201**: Done. Read \"Status\": successful, processing or failed. 200 also means \"same customer_ref, here is the first order\".\n- **400**: Refused, nothing charged. The reason is in \"error\" (text or a list of texts).\n- **401**: No API key, or a wrong one. Send the header Authorization: Token <your key>.\n- **403**: Your IP address is not in your IP whitelist, or the action is not for API users.\n- **404**: Not found (wrong address, or an order that is not yours).\n- **429**: Too many requests. Wait the seconds in the Retry-After header, then try again.\n- **500 / 502 / timeout**: No clear answer. Do not buy again: check the order with ?search=<your customer_ref or phone> first.\n\n## Limits\n- Orders: 60 a minute per API key.\n- Other requests (balance, lists, order checks): 120 a minute per API key.\n- Meter, smartcard and internet account checks: 30 a minute per account.\n- Wrong API keys: 30 in 10 minutes from one address, then that address waits 10 minutes.\n\n## Webhook\nSave your address on the API docs page. One POST per final answer (successful / failed, and again only if it changes), for every product. Header `X-Uzobest-Signature` = HMAC SHA512 of the raw body with your API key. Example body:\n\n```json\n{\n  \"product\": \"data\",\n  \"id\": 21067883,\n  \"ident\": \"Data8935fa7f7-2a0\",\n  \"customer_ref\": \"MYREF0001\",\n  \"Status\": \"successful\",\n  \"transaction_status\": \"successful\",\n  \"network\": \"MTN\",\n  \"mobile_number\": \"08031234567\",\n  \"plan\": 7,\n  \"purchased_plan\": \"1.0GB\",\n  \"data_type\": \"SME\",\n  \"plan_amount\": \"280.0\",\n  \"previous_balance\": \"5000.0\",\n  \"after_balance\": \"4720.0\",\n  \"api_response\": \"Dear Customer, You have successfully shared 1GB Data to 2348031234567.\",\n  \"transaction_date\": \"03, Nov 2026\",\n  \"create_date\": \"2026-11-03T10:15:02.123456+01:00\"\n}\n```\n\nThe ID lists (plans, networks, cable packages, electricity companies, recharge cards, internet plans) with YOUR prices: `GET {{base_url}}/api/plans/?product=data&network=MTN` (the request \"Plan IDs and your prices\"), or the Plan ID finder on the API docs page: https://uzobestgsm.com/documentation/",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "apikey",
    "apikey": [
      {
        "key": "key",
        "value": "Authorization",
        "type": "string"
      },
      {
        "key": "value",
        "value": "Token {{api_key}}",
        "type": "string"
      },
      {
        "key": "in",
        "value": "header",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "base_url",
      "value": "https://uzobestgsm.com"
    },
    {
      "key": "api_key",
      "value": ""
    }
  ],
  "item": [
    {
      "name": "Balance",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{base_url}}/api/user/",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "api",
            "user",
            ""
          ]
        },
        "description": "Your account. Your balance is `user.Account_Balance` (naira, with kobo)."
      },
      "response": [
        {
          "name": "Example reply",
          "originalRequest": {
            "method": "GET",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/user/",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "user",
                ""
              ]
            },
            "description": "Your account. Your balance is `user.Account_Balance` (naira, with kobo)."
          },
          "status": "OK",
          "code": 200,
          "_postman_previewlanguage": "json",
          "header": [
            {
              "key": "Content-Type",
              "value": "application/json"
            }
          ],
          "body": "{\n  \"user\": {\n    \"id\": 1001,\n    \"username\": \"adastores\",\n    \"email\": \"ada@example.com\",\n    \"user_type\": \"API\",\n    \"Account_Balance\": 25400.5,\n    \"wallet_balance\": \"25401\",\n    \"has_pin\": true\n  },\n  \"notification\": {\n    \"message\": \"\"\n  },\n  \"Dataplans\": {\n    \"MTN_PLAN\": {\n      \"ALL\": [\n        \"...\"\n      ]\n    }\n  }\n}"
        }
      ]
    },
    {
      "name": "Plan IDs and your prices",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{base_url}}/api/plans/?product=data&network=MTN",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "api",
            "plans",
            ""
          ],
          "query": [
            {
              "key": "product",
              "value": "data"
            },
            {
              "key": "network",
              "value": "MTN"
            }
          ]
        },
        "description": "Everything you can buy now with YOUR price. Send `id` or `named_id` in the field named in `send_as`. Refreshed every minute.\n\n- `product`: data, airtime, cable, electricity, exam, recharge, internet or networks (empty = everything)\n- `network`: Optional: a network or company, e.g. MTN or DStv\n- `type`: Optional, data only: e.g. SME, GIFTING"
      },
      "response": [
        {
          "name": "Example reply",
          "originalRequest": {
            "method": "GET",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/plans/?product=data&network=MTN",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "plans",
                ""
              ],
              "query": [
                {
                  "key": "product",
                  "value": "data"
                },
                {
                  "key": "network",
                  "value": "MTN"
                }
              ]
            },
            "description": "Everything you can buy now with YOUR price. Send `id` or `named_id` in the field named in `send_as`. Refreshed every minute.\n\n- `product`: data, airtime, cable, electricity, exam, recharge, internet or networks (empty = everything)\n- `network`: Optional: a network or company, e.g. MTN or DStv\n- `type`: Optional, data only: e.g. SME, GIFTING"
          },
          "status": "OK",
          "code": 200,
          "_postman_previewlanguage": "json",
          "header": [
            {
              "key": "Content-Type",
              "value": "application/json"
            }
          ],
          "body": "{\n  \"count\": 1,\n  \"plans\": [\n    {\n      \"product\": \"data\",\n      \"network\": \"MTN\",\n      \"type\": \"SME\",\n      \"name\": \"1GB\",\n      \"detail\": \"30 Days\",\n      \"price\": 280.0,\n      \"id\": \"7\",\n      \"named_id\": \"MTN_SME_1GB_30DAYS\",\n      \"send_as\": \"plan\",\n      \"off\": false\n    }\n  ]\n}"
        }
      ]
    },
    {
      "name": "Data",
      "description": "Buy a data plan for a phone number. Choose the plan ID from the Data plans list below.",
      "item": [
        {
          "name": "Buy data",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/data/",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "data",
                ""
              ]
            },
            "description": "Buy a data plan for a phone number. Choose the plan ID from the Data plans list below.\n\n| Field | Type | Required | What to send |\n|---|---|---|---|\n| `network` | integer | yes | Network ID (Networks list). |\n| `mobile_number` | string | yes | 11 digits, e.g. 08031234567. |\n| `plan` | integer or string | yes | Plan ID (Data plans list): the number (e.g. 7) or the named plan ID (e.g. MTN_SME_1GB_30DAYS). Both work; use either. |\n| `Ported_number` | boolean | no | true if the number moved from another network. Default false (we check that the number belongs to the network). |\n| `customer_ref` | string | no | Your own unique reference. Sending the same one again returns the first order instead of buying again. |",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"network\": 1,\n  \"mobile_number\": \"08031234567\",\n  \"plan\": 7,\n  \"Ported_number\": true,\n  \"customer_ref\": \"MYREF0001\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Example reply",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{base_url}}/api/data/",
                  "host": [
                    "{{base_url}}"
                  ],
                  "path": [
                    "api",
                    "data",
                    ""
                  ]
                },
                "description": "Buy a data plan for a phone number. Choose the plan ID from the Data plans list below.\n\n| Field | Type | Required | What to send |\n|---|---|---|---|\n| `network` | integer | yes | Network ID (Networks list). |\n| `mobile_number` | string | yes | 11 digits, e.g. 08031234567. |\n| `plan` | integer or string | yes | Plan ID (Data plans list): the number (e.g. 7) or the named plan ID (e.g. MTN_SME_1GB_30DAYS). Both work; use either. |\n| `Ported_number` | boolean | no | true if the number moved from another network. Default false (we check that the number belongs to the network). |\n| `customer_ref` | string | no | Your own unique reference. Sending the same one again returns the first order instead of buying again. |",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"network\": 1,\n  \"mobile_number\": \"08031234567\",\n  \"plan\": 7,\n  \"Ported_number\": true,\n  \"customer_ref\": \"MYREF0001\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"id\": 21067883,\n  \"ident\": \"Data8935fa7f7-2a0\",\n  \"customer_ref\": \"MYREF0001\",\n  \"network\": 1,\n  \"mobile_number\": \"08031234567\",\n  \"plan\": 7,\n  \"plan_code\": \"MTN_SME_1GB_30DAYS\",\n  \"plan_name\": \"1.0GB\",\n  \"plan_network\": \"MTN\",\n  \"plan_type\": \"SME\",\n  \"duration\": \"30 days\",\n  \"data_type\": \"SME\",\n  \"plan_amount\": \"280.0\",\n  \"balance_before\": \"5000.0\",\n  \"balance_after\": \"4720.0\",\n  \"Status\": \"successful\",\n  \"api_response\": \"Dear Customer, You have successfully shared 1GB Data to 2348031234567.\",\n  \"create_date\": \"2026-11-03T10:15:02.123456+01:00\",\n  \"Ported_number\": true\n}"
            }
          ]
        },
        {
          "name": "Check an order (search)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/data/?search=PUT_IDENT_HERE",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "data",
                ""
              ],
              "query": [
                {
                  "key": "search",
                  "value": "PUT_IDENT_HERE"
                }
              ]
            },
            "description": "Your orders whose ident, customer_ref, order id or number is exactly what you send (newest 20). Without `search`: your newest orders, 15 a page."
          }
        }
      ]
    },
    {
      "name": "Airtime",
      "description": "Send airtime to a phone number. You pay the percent of the amount shown in the Airtime list (e.g. pay 98% means \u20a698 for \u20a6100 airtime).",
      "item": [
        {
          "name": "Buy airtime",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/topup/",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "topup",
                ""
              ]
            },
            "description": "Send airtime to a phone number. You pay the percent of the amount shown in the Airtime list (e.g. pay 98% means \u20a698 for \u20a6100 airtime).\n\n| Field | Type | Required | What to send |\n|---|---|---|---|\n| `network` | integer | yes | Network ID (Networks list). |\n| `amount` | number | yes | Airtime value in naira, 50 or more. |\n| `mobile_number` | string | yes | 11 digits, e.g. 08031234567. |\n| `airtime_type` | string | yes | VTU (also \"awuf4U\" or \"Share and Sell\" where the Airtime list shows them). |\n| `Ported_number` | boolean | no | true if the number moved from another network. Default false. |",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"network\": 1,\n  \"amount\": 100,\n  \"mobile_number\": \"08031234567\",\n  \"airtime_type\": \"VTU\",\n  \"Ported_number\": true\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Example reply",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{base_url}}/api/topup/",
                  "host": [
                    "{{base_url}}"
                  ],
                  "path": [
                    "api",
                    "topup",
                    ""
                  ]
                },
                "description": "Send airtime to a phone number. You pay the percent of the amount shown in the Airtime list (e.g. pay 98% means \u20a698 for \u20a6100 airtime).\n\n| Field | Type | Required | What to send |\n|---|---|---|---|\n| `network` | integer | yes | Network ID (Networks list). |\n| `amount` | number | yes | Airtime value in naira, 50 or more. |\n| `mobile_number` | string | yes | 11 digits, e.g. 08031234567. |\n| `airtime_type` | string | yes | VTU (also \"awuf4U\" or \"Share and Sell\" where the Airtime list shows them). |\n| `Ported_number` | boolean | no | true if the number moved from another network. Default false. |",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"network\": 1,\n  \"amount\": 100,\n  \"mobile_number\": \"08031234567\",\n  \"airtime_type\": \"VTU\",\n  \"Ported_number\": true\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"id\": 3520011,\n  \"ident\": \"Airtime0e1f2a3b4c5\",\n  \"network\": 1,\n  \"mobile_number\": \"08031234567\",\n  \"airtime_type\": \"VTU\",\n  \"amount\": \"100\",\n  \"paid_amount\": \"98.0\",\n  \"plan_amount\": \"98.0\",\n  \"plan_network\": \"MTN\",\n  \"balance_before\": \"5000.0\",\n  \"balance_after\": \"4902.0\",\n  \"Status\": \"successful\",\n  \"create_date\": \"2026-11-03T10:16:40.000000+01:00\",\n  \"Ported_number\": true\n}"
            }
          ]
        },
        {
          "name": "Check an order (search)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/topup/?search=PUT_IDENT_HERE",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "topup",
                ""
              ],
              "query": [
                {
                  "key": "search",
                  "value": "PUT_IDENT_HERE"
                }
              ]
            },
            "description": "Your orders whose ident, customer_ref, order id or number is exactly what you send (newest 20). Without `search`: your newest orders, 15 a page."
          }
        }
      ]
    },
    {
      "name": "Cable TV",
      "description": "Pay a DStv, GOtv or StarTimes package. Check the smartcard first to see the owner's name.",
      "item": [
        {
          "name": "Check the smartcard first",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/validateiuc/?smart_card_number=7012345678&cablename=GOTV",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "validateiuc",
                ""
              ],
              "query": [
                {
                  "key": "smart_card_number",
                  "value": "7012345678"
                },
                {
                  "key": "cablename",
                  "value": "GOTV"
                }
              ]
            },
            "description": "Nothing is charged. `invalid: false` = found; `name` = the owner.\n\n- `smart_card_number`: Smartcard / IUC number.\n- `cablename`: Cable company name, e.g. GOTV, DSTV or STARTIME (its ID from the Cable list also works)."
          },
          "response": [
            {
              "name": "Example reply",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{base_url}}/api/validateiuc/?smart_card_number=7012345678&cablename=GOTV",
                  "host": [
                    "{{base_url}}"
                  ],
                  "path": [
                    "api",
                    "validateiuc",
                    ""
                  ],
                  "query": [
                    {
                      "key": "smart_card_number",
                      "value": "7012345678"
                    },
                    {
                      "key": "cablename",
                      "value": "GOTV"
                    }
                  ]
                },
                "description": "Nothing is charged. `invalid: false` = found; `name` = the owner.\n\n- `smart_card_number`: Smartcard / IUC number.\n- `cablename`: Cable company name, e.g. GOTV, DSTV or STARTIME (its ID from the Cable list also works)."
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"invalid\": false,\n  \"name\": \"ADA OKAFOR\"\n}"
            }
          ]
        },
        {
          "name": "Buy cable tv",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/cablesub/",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "cablesub",
                ""
              ]
            },
            "description": "Pay a DStv, GOtv or StarTimes package. Check the smartcard first to see the owner's name.\n\n| Field | Type | Required | What to send |\n|---|---|---|---|\n| `cablename` | integer | yes | Cable company ID (Cable list). |\n| `cableplan` | integer | yes | Package ID (Cable list). |\n| `smart_card_number` | string | yes | Smartcard / IUC number (digits). |",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"cablename\": 1,\n  \"cableplan\": 12,\n  \"smart_card_number\": \"7012345678\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Example reply",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{base_url}}/api/cablesub/",
                  "host": [
                    "{{base_url}}"
                  ],
                  "path": [
                    "api",
                    "cablesub",
                    ""
                  ]
                },
                "description": "Pay a DStv, GOtv or StarTimes package. Check the smartcard first to see the owner's name.\n\n| Field | Type | Required | What to send |\n|---|---|---|---|\n| `cablename` | integer | yes | Cable company ID (Cable list). |\n| `cableplan` | integer | yes | Package ID (Cable list). |\n| `smart_card_number` | string | yes | Smartcard / IUC number (digits). |",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"cablename\": 1,\n  \"cableplan\": 12,\n  \"smart_card_number\": \"7012345678\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"id\": 99120,\n  \"ident\": \"Cable1a2b3c4d5e6\",\n  \"cablename\": 1,\n  \"cableplan\": 12,\n  \"package\": \"DStv Compact\",\n  \"plan_amount\": \"19000\",\n  \"paid_amount\": \"19000.0\",\n  \"balance_before\": \"50000.0\",\n  \"balance_after\": \"31000.0\",\n  \"smart_card_number\": \"7012345678\",\n  \"customer_name\": \"ADA OKAFOR\",\n  \"Status\": \"successful\",\n  \"api_response\": \"Your order was successful.\",\n  \"create_date\": \"2026-11-03T10:20:00.000000+01:00\"\n}"
            }
          ]
        },
        {
          "name": "Check an order (search)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/cablesub/?search=PUT_IDENT_HERE",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "cablesub",
                ""
              ],
              "query": [
                {
                  "key": "search",
                  "value": "PUT_IDENT_HERE"
                }
              ]
            },
            "description": "Your orders whose ident, customer_ref, order id or number is exactly what you send (newest 20). Without `search`: your newest orders, 15 a page."
          }
        }
      ]
    },
    {
      "name": "Electricity",
      "description": "Buy a prepaid token or pay a postpaid bill. Check the meter first to see the owner's name. The token is in the reply (\"token\") when the order is successful.",
      "item": [
        {
          "name": "Check the meter first",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/validatemeter/?meternumber=45012345678&disconame=3&mtype=Prepaid",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "validatemeter",
                ""
              ],
              "query": [
                {
                  "key": "meternumber",
                  "value": "45012345678"
                },
                {
                  "key": "disconame",
                  "value": "3"
                },
                {
                  "key": "mtype",
                  "value": "Prepaid"
                }
              ]
            },
            "description": "Nothing is charged. `invalid: false` = found; `name` = the owner.\n\n- `meternumber`: Meter number.\n- `disconame`: Electricity company ID or name (Electricity list).\n- `mtype`: Prepaid or Postpaid (1 or 2 also work)."
          },
          "response": [
            {
              "name": "Example reply",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{base_url}}/api/validatemeter/?meternumber=45012345678&disconame=3&mtype=Prepaid",
                  "host": [
                    "{{base_url}}"
                  ],
                  "path": [
                    "api",
                    "validatemeter",
                    ""
                  ],
                  "query": [
                    {
                      "key": "meternumber",
                      "value": "45012345678"
                    },
                    {
                      "key": "disconame",
                      "value": "3"
                    },
                    {
                      "key": "mtype",
                      "value": "Prepaid"
                    }
                  ]
                },
                "description": "Nothing is charged. `invalid: false` = found; `name` = the owner.\n\n- `meternumber`: Meter number.\n- `disconame`: Electricity company ID or name (Electricity list).\n- `mtype`: Prepaid or Postpaid (1 or 2 also work)."
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"invalid\": false,\n  \"name\": \"ADA OKAFOR\",\n  \"address\": \"12 MARKET ROAD, ENUGU\"\n}"
            }
          ]
        },
        {
          "name": "Buy electricity",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/billpayment/",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "billpayment",
                ""
              ]
            },
            "description": "Buy a prepaid token or pay a postpaid bill. Check the meter first to see the owner's name. The token is in the reply (\"token\") when the order is successful.\n\n| Field | Type | Required | What to send |\n|---|---|---|---|\n| `disco_name` | integer | yes | Electricity company ID (Electricity list). |\n| `amount` | number | yes | Amount in naira (the Electricity list shows the minimum). |\n| `meter_number` | string | yes | Meter number (digits). |\n| `MeterType` | string | yes | Prepaid or Postpaid (1 or 2 also work). |\n| `Customer_Phone` | string | yes | The customer's phone number, 11 digits. |",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"disco_name\": 3,\n  \"amount\": 2000,\n  \"meter_number\": \"45012345678\",\n  \"MeterType\": \"Prepaid\",\n  \"Customer_Phone\": \"08031234567\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Example reply",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{base_url}}/api/billpayment/",
                  "host": [
                    "{{base_url}}"
                  ],
                  "path": [
                    "api",
                    "billpayment",
                    ""
                  ]
                },
                "description": "Buy a prepaid token or pay a postpaid bill. Check the meter first to see the owner's name. The token is in the reply (\"token\") when the order is successful.\n\n| Field | Type | Required | What to send |\n|---|---|---|---|\n| `disco_name` | integer | yes | Electricity company ID (Electricity list). |\n| `amount` | number | yes | Amount in naira (the Electricity list shows the minimum). |\n| `meter_number` | string | yes | Meter number (digits). |\n| `MeterType` | string | yes | Prepaid or Postpaid (1 or 2 also work). |\n| `Customer_Phone` | string | yes | The customer's phone number, 11 digits. |",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"disco_name\": 3,\n  \"amount\": 2000,\n  \"meter_number\": \"45012345678\",\n  \"MeterType\": \"Prepaid\",\n  \"Customer_Phone\": \"08031234567\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"id\": 41200,\n  \"ident\": \"Bill9f8e7d6c5b4a\",\n  \"disco_name\": 3,\n  \"package\": \"Ikeja Electric\",\n  \"amount\": \"2000\",\n  \"paid_amount\": \"2000.0\",\n  \"meter_number\": \"45012345678\",\n  \"MeterType\": \"Prepaid\",\n  \"Customer_Phone\": \"08031234567\",\n  \"token\": \"1234-5678-9012-3456-7890\",\n  \"units\": \"28.5\",\n  \"customer_name\": \"ADA OKAFOR\",\n  \"customer_address\": \"12 MARKET ROAD\",\n  \"balance_before\": \"50000.0\",\n  \"balance_after\": \"48000.0\",\n  \"Status\": \"successful\",\n  \"api_response\": \"Token: 1234-5678-9012-3456-7890\",\n  \"create_date\": \"2026-11-03T10:25:00.000000+01:00\"\n}"
            }
          ]
        },
        {
          "name": "Check an order (search)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/billpayment/?search=PUT_IDENT_HERE",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "billpayment",
                ""
              ],
              "query": [
                {
                  "key": "search",
                  "value": "PUT_IDENT_HERE"
                }
              ]
            },
            "description": "Your orders whose ident, customer_ref, order id or number is exactly what you send (newest 20). Without `search`: your newest orders, 15 a page."
          }
        }
      ]
    },
    {
      "name": "Exam pins",
      "description": "Buy WAEC, NECO or NABTEB result checker pins. The pins are in the reply (\"pins\") when the order is successful.",
      "item": [
        {
          "name": "Buy exam pins",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/epin/",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "epin",
                ""
              ]
            },
            "description": "Buy WAEC, NECO or NABTEB result checker pins. The pins are in the reply (\"pins\") when the order is successful.\n\n| Field | Type | Required | What to send |\n|---|---|---|---|\n| `exam_name` | string | yes | WAEC, NECO or NABTEB (Exam list). |\n| `quantity` | integer | yes | How many pins (the Exam list shows the most per order). |",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"exam_name\": \"WAEC\",\n  \"quantity\": 1\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Example reply",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{base_url}}/api/epin/",
                  "host": [
                    "{{base_url}}"
                  ],
                  "path": [
                    "api",
                    "epin",
                    ""
                  ]
                },
                "description": "Buy WAEC, NECO or NABTEB result checker pins. The pins are in the reply (\"pins\") when the order is successful.\n\n| Field | Type | Required | What to send |\n|---|---|---|---|\n| `exam_name` | string | yes | WAEC, NECO or NABTEB (Exam list). |\n| `quantity` | integer | yes | How many pins (the Exam list shows the most per order). |",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"exam_name\": \"WAEC\",\n  \"quantity\": 1\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"id\": 8801,\n  \"exam_name\": \"WAEC\",\n  \"quantity\": 1,\n  \"pins\": \"Serial No:WRN123456789 Pin:123456789012\",\n  \"amount\": 3400.0,\n  \"previous_balance\": \"5000.0\",\n  \"after_balance\": \"1600.0\",\n  \"Status\": \"successful\",\n  \"create_date\": \"2026-11-03T10:30:00.000000+01:00\"\n}"
            }
          ]
        },
        {
          "name": "Check an order (search)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/epin/?search=PUT_IDENT_HERE",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "epin",
                ""
              ],
              "query": [
                {
                  "key": "search",
                  "value": "PUT_IDENT_HERE"
                }
              ]
            },
            "description": "Your orders whose ident, customer_ref, order id or number is exactly what you send (newest 20). Without `search`: your newest orders, 15 a page."
          }
        }
      ]
    },
    {
      "name": "Recharge pins",
      "description": "Buy printable recharge card pins. Choose the card ID from the Recharge pins list (it shows the cards left).",
      "item": [
        {
          "name": "Buy recharge pins",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/rechargepin/",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "rechargepin",
                ""
              ]
            },
            "description": "Buy printable recharge card pins. Choose the card ID from the Recharge pins list (it shows the cards left).\n\n| Field | Type | Required | What to send |\n|---|---|---|---|\n| `network` | integer | yes | Network ID (Recharge pins list). |\n| `network_amount` | integer | yes | Card ID (Recharge pins list), not the naira value. |\n| `quantity` | integer | yes | How many cards (the Recharge pins list shows the most per order). |\n| `name_on_card` | string | yes | Your business name, printed on the cards. |",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"network\": 1,\n  \"network_amount\": 4,\n  \"quantity\": 2,\n  \"name_on_card\": \"ADA STORES\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Example reply",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{base_url}}/api/rechargepin/",
                  "host": [
                    "{{base_url}}"
                  ],
                  "path": [
                    "api",
                    "rechargepin",
                    ""
                  ]
                },
                "description": "Buy printable recharge card pins. Choose the card ID from the Recharge pins list (it shows the cards left).\n\n| Field | Type | Required | What to send |\n|---|---|---|---|\n| `network` | integer | yes | Network ID (Recharge pins list). |\n| `network_amount` | integer | yes | Card ID (Recharge pins list), not the naira value. |\n| `quantity` | integer | yes | How many cards (the Recharge pins list shows the most per order). |\n| `name_on_card` | string | yes | Your business name, printed on the cards. |",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"network\": 1,\n  \"network_amount\": 4,\n  \"quantity\": 2,\n  \"name_on_card\": \"ADA STORES\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"id\": 5120,\n  \"network\": 1,\n  \"network_name\": \"MTN\",\n  \"network_amount\": 4,\n  \"card_amount\": \"100\",\n  \"quantity\": 2,\n  \"name_on_card\": \"ADA STORES\",\n  \"data_pin\": \"[...the pins...]\",\n  \"amount\": 196.0,\n  \"previous_balance\": \"5000.0\",\n  \"after_balance\": \"4804.0\",\n  \"Status\": \"successful\",\n  \"create_date\": \"2026-11-03T10:35:00.000000+01:00\"\n}"
            }
          ]
        },
        {
          "name": "Check an order (search)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/rechargepin/?search=PUT_IDENT_HERE",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "rechargepin",
                ""
              ],
              "query": [
                {
                  "key": "search",
                  "value": "PUT_IDENT_HERE"
                }
              ]
            },
            "description": "Your orders whose ident, customer_ref, order id or number is exactly what you send (newest 20). Without `search`: your newest orders, 15 a page."
          }
        }
      ]
    },
    {
      "name": "Internet",
      "description": "Renew an internet plan (MTN Fibre X, Smile and others in the Internet list). Check the account first to see the owner's name, then buy with the account number or the phone number the company asks for.",
      "item": [
        {
          "name": "Check the account first",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/validateinternet/?provider=SMILE&number=1402000123",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "validateinternet",
                ""
              ],
              "query": [
                {
                  "key": "provider",
                  "value": "SMILE"
                },
                {
                  "key": "number",
                  "value": "1402000123"
                }
              ]
            },
            "description": "Nothing is charged. `invalid: false` = found; `name` = the owner.\n\n- `provider`: Internet company ID or name from the Internet list, e.g. MTN Fibre X or Smile. Send this or plan.\n- `plan`: Or the internet plan ID (or named ID) you are about to buy; the company is taken from it.\n- `number`: The account number (a Smile customer's email also works)."
          },
          "response": [
            {
              "name": "Example reply",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{base_url}}/api/validateinternet/?provider=SMILE&number=1402000123",
                  "host": [
                    "{{base_url}}"
                  ],
                  "path": [
                    "api",
                    "validateinternet",
                    ""
                  ],
                  "query": [
                    {
                      "key": "provider",
                      "value": "SMILE"
                    },
                    {
                      "key": "number",
                      "value": "1402000123"
                    }
                  ]
                },
                "description": "Nothing is charged. `invalid: false` = found; `name` = the owner.\n\n- `provider`: Internet company ID or name from the Internet list, e.g. MTN Fibre X or Smile. Send this or plan.\n- `plan`: Or the internet plan ID (or named ID) you are about to buy; the company is taken from it.\n- `number`: The account number (a Smile customer's email also works)."
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"invalid\": false,\n  \"name\": \"ADA OKAFOR\",\n  \"account\": \"1402000123\",\n  \"error\": \"\"\n}"
            }
          ]
        },
        {
          "name": "Buy internet",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/internet/",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "internet",
                ""
              ]
            },
            "description": "Renew an internet plan (MTN Fibre X, Smile and others in the Internet list). Check the account first to see the owner's name, then buy with the account number or the phone number the company asks for.\n\n| Field | Type | Required | What to send |\n|---|---|---|---|\n| `plan` | integer | yes | Internet plan ID (Internet list). |\n| `smart_number` | string | yes | The account number (or phone number, where the Internet list says so). |\n| `customer_name` | string | no | Optional, for your own records. |",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"plan\": 15,\n  \"smart_number\": \"1402000123\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Example reply",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{base_url}}/api/internet/",
                  "host": [
                    "{{base_url}}"
                  ],
                  "path": [
                    "api",
                    "internet",
                    ""
                  ]
                },
                "description": "Renew an internet plan (MTN Fibre X, Smile and others in the Internet list). Check the account first to see the owner's name, then buy with the account number or the phone number the company asks for.\n\n| Field | Type | Required | What to send |\n|---|---|---|---|\n| `plan` | integer | yes | Internet plan ID (Internet list). |\n| `smart_number` | string | yes | The account number (or phone number, where the Internet list says so). |\n| `customer_name` | string | no | Optional, for your own records. |",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"plan\": 15,\n  \"smart_number\": \"1402000123\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"id\": 701,\n  \"ident\": \"Net5d4c3b2a1f0e\",\n  \"Status\": \"successful\",\n  \"api_response\": \"Your internet plan is active.\",\n  \"pins\": \"\",\n  \"plan\": \"Smile 10GB 30 days\",\n  \"smart_number\": \"1402000123\",\n  \"paid_amount\": 4950.0\n}"
            }
          ]
        },
        {
          "name": "Check an order (search)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/internet/?search=PUT_IDENT_HERE",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "internet",
                ""
              ],
              "query": [
                {
                  "key": "search",
                  "value": "PUT_IDENT_HERE"
                }
              ]
            },
            "description": "Your orders whose ident, customer_ref, order id or number is exactly what you send (newest 20). Without `search`: your newest orders, 15 a page."
          }
        }
      ]
    },
    {
      "name": "Bulk SMS",
      "description": "Send one text message to many numbers. The price is per number, per page of 160 characters.",
      "item": [
        {
          "name": "Buy bulk sms",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/sendsms/",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "sendsms",
                ""
              ]
            },
            "description": "Send one text message to many numbers. The price is per number, per page of 160 characters.\n\n| Field | Type | Required | What to send |\n|---|---|---|---|\n| `sender` | string | yes | Sender name shown on the phones: up to 11 letters and numbers (or up to 16 digits). |\n| `recipient` | string | yes | Phone numbers separated by commas, e.g. 08031234567,08051234567. |\n| `message` | string | yes | The text. No emojis. |",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"sender\": \"ADASTORES\",\n  \"recipient\": \"08031234567,08051234567\",\n  \"message\": \"Our shop opens at 8am tomorrow.\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Example reply",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{base_url}}/api/sendsms/",
                  "host": [
                    "{{base_url}}"
                  ],
                  "path": [
                    "api",
                    "sendsms",
                    ""
                  ]
                },
                "description": "Send one text message to many numbers. The price is per number, per page of 160 characters.\n\n| Field | Type | Required | What to send |\n|---|---|---|---|\n| `sender` | string | yes | Sender name shown on the phones: up to 11 letters and numbers (or up to 16 digits). |\n| `recipient` | string | yes | Phone numbers separated by commas, e.g. 08031234567,08051234567. |\n| `message` | string | yes | The text. No emojis. |",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"sender\": \"ADASTORES\",\n  \"recipient\": \"08031234567,08051234567\",\n  \"message\": \"Our shop opens at 8am tomorrow.\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"id\": 9910,\n  \"ident\": \"Sms0a1b2c3d4e5f\",\n  \"Status\": \"processing\",\n  \"message\": \"Your message is being sent.\",\n  \"error\": \"Your message is being sent.\"\n}"
            }
          ]
        },
        {
          "name": "Check an order (search)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/sendsms/?search=PUT_IDENT_HERE",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "sendsms",
                ""
              ],
              "query": [
                {
                  "key": "search",
                  "value": "PUT_IDENT_HERE"
                }
              ]
            },
            "description": "Your orders whose ident, customer_ref, order id or number is exactly what you send (newest 20). Without `search`: your newest orders, 15 a page."
          }
        }
      ]
    }
  ]
}