Skip to main content
POST
Validate Electricity Meter

Overview

Validate an electricity meter number against the specified distribution company (DisCo) to ensure it belongs to a valid customer and retrieve their details.

Request Body

Response Fields

string
Customer name returned for the meter.
string
Customer address returned for the meter.
number
Minimum amount accepted for the meter.
number
Outstanding amount returned for the meter, when available.

Notes

  • Call Electricity Providers first and use the returned productCode as disco.
  • vendType should match the customer’s meter type, such as PREPAID or POSTPAID.
  • Show the returned customer name, address, minimum amount, and outstanding amount to the customer before purchase.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
meter
string
required

The electricity meter number to validate

Example:

"12345678910"

disco
string
required

Electricity provider productCode returned by the ElectricityList endpoint

Example:

"IKEJA_ELECTRIC"

vendType
enum<string>
required

Meter type

Available options:
PREPAID,
POSTPAID
Example:

"PREPAID"

Response

200 - application/json

Successfully Processed

gatewayStatus
string
Example:

"00"

gatewayMessage
string
Example:

"Successfully Processed"

requestReference
string
Example:

"bpr_req_a1b2c3d4e5f6"

data
object