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"
  }'
const response = await fetch("https://tente.com.ng/api/v1/electricity", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
    "Accept": "application/json"
  },
  body: JSON.stringify({
    serviceID: "ikeja-electric",
    billersCode: "01011509182",
    variation_code: "prepaid",
    amount: 5000,
    phone: "08031234567",
    request_id: "REQ_ELE_" + Date.now()
  })
});

const result = await response.json();
console.log(result);
<?php

$client = new \GuzzleHttp\Client();

$response = $client->post('https://tente.com.ng/api/v1/electricity', [
    'headers' => [
        'Authorization' => 'Bearer YOUR_API_TOKEN',
        'Content-Type'  => 'application/json',
        'Accept'        => 'application/json',
    ],
    'json' => [
        'serviceID'      => 'ikeja-electric',
        'billersCode'    => '01011509182',
        'variation_code' => 'prepaid',
        'amount'         => 5000,
        'phone'          => '08031234567',
        'request_id'     => 'REQ_ELE_' . uniqid(),
    ]
]);

$data = json_decode($response->getBody(), true);
print_r($data);
import requests

url = "https://tente.com.ng/api/v1/electricity"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
    "Accept": "application/json"
}
payload = {
    "serviceID": "ikeja-electric",
    "billersCode": "01011509182",
    "variation_code": "prepaid",
    "amount": 5000,
    "phone": "08031234567",
    "request_id": "REQ_ELE_123456"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

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-electric108Lagos (Ikeja, Ikorodu, etc.)
Eko Electric (EKEDC)eko-electric109Lagos (Island, Lekki, Apapa, etc.)
Abuja Electric (AEDC)abuja-electric205FCT Abuja, Kogi, Nasarawa, Niger
Ibadan Electric (IBEDC)ibadan-electric203Oyo, Ogun, Osun, Kwara
Kano Electric (KEDCO)kano-electric200Kano, Katsina, Jigawa
Port Harcourt Electric (PHED)portharcourt-electric201Rivers, Bayelsa, Cross River, Akwa Ibom
Enugu Electric (EEDC)enugu-electric206Enugu, Abia, Imo, Anambra, Ebonyi
Benin Electric (BEDC)benin-electric207Edo, Delta, Ondo, Ekiti
Kaduna Electric (KAEDCO)kaduna-electric204Kaduna, Kebbi, Sokoto, Zamfara
Jos Electric (JED)jos-electric202Plateau, Bauchi, Benue, Gombe
Aba Electric (ABA)aba-electric208Aba Ring-fenced Zone
Yola Electric (YEDC)yola-electric209Adamawa, 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."
}