API reference

Electricity

Check a meter, then buy a prepaid token or pay a postpaid bill.

POSThttps://uzobestgsm.com/api/v2/electricity/

Header Authorization: Bearer YOUR_API_KEY. Try it free with your test key.

Check the meter first

Optional. Shows the customer's name. Nothing is charged.

Request
curl "https://uzobestgsm.com/api/v2/verify/meter/?provider=IKEJA&meter_number=45012345678&meter_type=prepaid" -H "Authorization: Bearer YOUR_API_KEY"

What to send

FieldWhat it is
referencerequiredYour own unique ID for this order (1 to 64 letters, digits, dot, dash or underscore).
providerrequiredThe company's named ID, e.g. GOTV, DSTV or IKEJA.
meter_numberrequiredMeter number.
meter_typerequiredprepaid or postpaid.
amountrequiredNaira.
phonerequired11 digits, e.g. 08031234567 (+234 and 234 are accepted).

Example

curl -X POST https://uzobestgsm.com/api/v2/electricity/ \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"reference": "ORD10026", "provider": "IKEJA", "meter_number": "45012345678", "meter_type": "prepaid", "amount": 2000, "phone": "08031234567"}'

The answer

Read data.status: successful, pending or failed (refunded).

Answer
{ "status": true, "message": "Order successful.", "data": { "reference": "ORD10026", "id": "Data8935fa7f7", "service": "electricity", "status": "successful", "message": "Order successful.", "amount": "1000.00", "balance_before": "5000.00", "balance_after": "4000.00", "account": "45012345678", "token": "1234 5678 9012 3456 7890", "units": "45.6" }, "request_id": "req_3f9a1c2b7d4e5f60" }

Pending? Look it up. Refused? See Errors.

Using the Classic / MSORG address instead?
POST https://uzobestgsm.com/api/billpayment/, header Token YOUR_API_KEY, fields disco_name, amount, meter_number, MeterType, Customer_Phone.

Updated 2026-11-20. Questions? Contact support.