Skip to main content
Purchase prepaid or postpaid electricity tokens. Supports all major Nigerian electricity distribution companies (DISCOs).

​
Get Electricity Billers

Retrieve the list of available electricity providers and their plan types. 
GET /api/v1/business/vas/electricity/billers
Signature required: Yes

​
Request example

curl -X GET "https://api-dev.usenumero.com/numeroaccount/api/v1/business/vas/electricity/billers" \
  -H "x-api-key: your_api_key" \
  -H "x-signature-key: generated_signature"

​
Response

{
  "status": true,
  "message": "Successful",
  "code": "200",
  "data": {
    "billers": [
      {
        "itemCode": "IKEDC_PREPAID",
        "itemName": "Ikeja Electric - Prepaid",
        "category": "electricity"
      },
      {
        "itemCode": "EKEDC_POSTPAID",
        "itemName": "Eko Electric - Postpaid",
        "category": "electricity"
      }
    ]
  }
}

​
Validate Meter Number

Verify a customer’s meter number before purchasing electricity. 
POST /api/v1/business/vas/electricity/validate
Signature required: Yes

​
Request body

FieldTypeRequiredDescription
typestringYesBiller item code (from billers list)
accountNumberstringYesCustomer’s meter number

​
Request example

curl -X POST "https://api-dev.usenumero.com/numeroaccount/api/v1/business/vas/electricity/validate" \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_api_key" \
  -H "x-signature-key: generated_signature" \
  -d '{
    "type": "IKEDC_PREPAID",
    "accountNumber": "04123456789"
  }'

​
Response

{
  "status": true,
  "message": "Successful",
  "code": "200",
  "data": {
    "message": "Validation successful",
    "data": {
      "customerName": "John Doe",
      "meterNumber": "04123456789",
      "address": "123 Allen Avenue, Ikeja"
    }
  }
}

​
Purchase Electricity

Purchase an electricity token for a validated meter. 
POST /api/v1/business/vas/electricity/purchase
Signature required: Yes

​
Request body

FieldTypeRequiredDescription
referencestringYesYour unique transaction reference
typestringYesBiller item code
discostringYesDistribution company code
accountNumberstringYesCustomer’s meter number
phonestringYesCustomer’s phone number
amountnumberYesAmount in Naira

​
Request example

curl -X POST "https://api-dev.usenumero.com/numeroaccount/api/v1/business/vas/electricity/purchase" \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_api_key" \
  -H "x-signature-key: generated_signature" \
  -d '{
    "reference": "ELEC-20240115-001",
    "type": "IKEDC_PREPAID",
    "disco": "IKEDC",
    "accountNumber": "04123456789",
    "phone": "08012345678",
    "amount": 5000
  }'

​
Response

{
  "status": true,
  "message": "Successful",
  "code": "200",
  "data": {
    "message": "Purchase successful",
    "reference": "ELEC-20240115-001",
    "data": {
      "token": "1234-5678-9012-3456-7890",
      "units": "25.5 kWh"
    }
  }
}