POST
/api/v1/electricity
The Electricity API provides real-time DISCO meter number validation, prepaid token generation, and postpaid bill settlement across all 12 electricity distribution companies (IKEDC, EKEDC, AEDC, IBEDC, KEDCO, PHED, EEDC, BEDC, KAEDCO, JED, ABA, YEDC).
⚡ Automated 20-Digit Token Vending
Instant Token Extraction: The 20-digit prepaid meter recharge token (e.g.
4401-2940-1928-4820-1940) and calculated energy units (kWh) are returned immediately in the JSON payload and via SMS.
POST
/api/v1/electricity-verify
Validate meter numbers to retrieve customer name, billing address, and account status before taking payment.
Request Parameters (JSON Body)
| Parameter | Type | Required | Description |
|---|---|---|---|
serviceID |
string | Required | DISCO service ID (e.g. ikeja-electric, abuja-electric, eko-electric). |
billersCode |
string | Required | Prepaid or Postpaid meter number (e.g. 01011509182). |
type |
string | Required | Meter type: prepaid or postpaid. |
Sample Verification Response
{
"status": "success",
"message": "Meter verified successfully",
"data": {
"Customer_Name": "DR. ADEBAYO MUSTAPHA",
"Address": "14 ADENIYI JONES AVENUE, IKEJA, LAGOS",
"Meter_Number": "01011509182",
"Meter_Type": "PREPAID",
"Disco": "IKEJA-ELECTRIC",
"Min_Vend": 500.00
}
}
Purchase Electricity Recharge Endpoint (POST)
| Parameter | Type | Required | Description & Example |
|---|---|---|---|
serviceID |
string | Required | DISCO identifier (e.g. ikeja-electric, abuja-electric). |
billersCode |
string | Required | Meter number. |
variation_code |
string | Required | prepaid or postpaid (e.g. ikeja-electric-prepaid or prepaid). |
amount |
numeric | Required | Recharge amount in Naira (Min: ₦500). |
phone |
string | Required | Customer's 11-digit SMS delivery phone number. |
request_id |
string | Optional | Unique merchant client tracking reference. |
Integration Code Examples
curl -X POST "https://tente.com.ng/api/v1/electricity" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"serviceID": "ikeja-electric",
"billersCode": "01011509182",
"variation_code": "prepaid",
"amount": 5000,
"phone": "08031234567",
"request_id": "REQ_ELE_99120"
}'
Sample 200 OK Success Response (With Token)
{
"status": "success",
"message": "Electricity recharge of ₦5,000.00 to Meter 01011509182 was successful.",
"data": {
"transaction_ref": "ELE2026083114280144FF",
"request_id": "REQ_ELE_99120",
"service_id": "ikeja-electric",
"disco_name": "Ikeja Electric (IKEDC)",
"meter_number": "01011509182",
"meter_type": "prepaid",
"amount": 5000.00,
"token": "4401-2940-1928-4820-1940",
"units": "34.8 kWh",
"phone": "08031234567",
"type": "Electricity Bill Payment",
"commission_rate": "1%",
"commission_earned": 50.00,
"new_balance": 37251.50,
"status": "completed",
"created_at": "2026-08-31T14:28:01+01:00"
}
}
Supported Electricity DISCOs Reference
| Distribution Company | Service ID | Numeric Code | Coverage Area |
|---|---|---|---|
| Ikeja Electric (IKEDC) | ikeja-electric | 108 | Lagos (Ikeja, Ikorodu, etc.) |
| Eko Electric (EKEDC) | eko-electric | 109 | Lagos (Island, Lekki, Apapa, etc.) |
| Abuja Electric (AEDC) | abuja-electric | 205 | FCT Abuja, Kogi, Nasarawa, Niger |
| Ibadan Electric (IBEDC) | ibadan-electric | 203 | Oyo, Ogun, Osun, Kwara |
| Kano Electric (KEDCO) | kano-electric | 200 | Kano, Katsina, Jigawa |
| Port Harcourt Electric (PHED) | portharcourt-electric | 201 | Rivers, Bayelsa, Cross River, Akwa Ibom |
| Enugu Electric (EEDC) | enugu-electric | 206 | Enugu, Abia, Imo, Anambra, Ebonyi |
| Benin Electric (BEDC) | benin-electric | 207 | Edo, Delta, Ondo, Ekiti |
| Kaduna Electric (KAEDCO) | kaduna-electric | 204 | Kaduna, Kebbi, Sokoto, Zamfara |
| Jos Electric (JED) | jos-electric | 202 | Plateau, Bauchi, Benue, Gombe |
| Aba Electric (ABA) | aba-electric | 208 | Aba Ring-fenced Zone |
| Yola Electric (YEDC) | yola-electric | 209 | Adamawa, Borno, Taraba, Yobe |
Error Responses
400 Meter Verification Failed
{
"status": "error",
"message": "Unable to verify meter number with DISCO."
}
402 Insufficient Balance
{
"status": "error",
"message": "Insufficient wallet balance."
}