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
| Field | What it is |
|---|---|
| referencerequired | Your own unique ID for this order (1 to 64 letters, digits, dot, dash or underscore). |
| providerrequired | The company's named ID, e.g. GOTV, DSTV or IKEJA. |
| meter_numberrequired | Meter number. |
| meter_typerequired | prepaid or postpaid. |
| amountrequired | Naira. |
| phonerequired | 11 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"}'
$ch = curl_init('https://uzobestgsm.com/api/v2/electricity/');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 150,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY', 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => json_encode([
'reference' => 'ORD10026',
'provider' => 'IKEJA',
'meter_number' => '45012345678',
'meter_type' => 'prepaid',
'amount' => 2000,
'phone' => '08031234567'
]),
]);
$answer = json_decode(curl_exec($ch), true);
const res = await fetch('https://uzobestgsm.com/api/v2/electricity/', {
method: 'POST',
headers: { Authorization: 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' },
body: JSON.stringify({"reference": "ORD10026", "provider": "IKEJA", "meter_number": "45012345678", "meter_type": "prepaid", "amount": 2000, "phone": "08031234567"}),
});
const answer = await res.json();
import requests
answer = requests.post(
'https://uzobestgsm.com/api/v2/electricity/',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={"reference": "ORD10026", "provider": "IKEJA", "meter_number": "45012345678", "meter_type": "prepaid", "amount": 2000, "phone": "08031234567"},
timeout=150,
).json()
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.

