Verify a meter

POST

/v1/electricity/b2b/verify

Looks a meter up with its distribution company, so you can confirm the customer’s name and the minimum amount before paying.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Success

Bodyapplication/json

🟠400

🟠401

🟠403

🟠429

Request Example

Shell

JavaScript

Java

Swift

curl --location 'http://localhost:5050/v1/electricity/b2b/verify' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "disco": "IKEJA",
    "meterNumber": "45067891234",
    "meterType": "PREPAID"
}'

Response Example

200 - Success

{
    "success": true,
    "message": "Request successful",
    "statusCode": 200,
    "path": "/v1/…",
    "timestamp": "2026-09-26T12:00:00.000Z",
    "hash": "a1b2c3d4-…",
    "data": {
        "customerId": "45067891234",
        "name": "ADA OBI",
        "address": "12 Allen Avenue, Ikeja",
        "minAmount": 1000,
        "maxAmount": null,
        "outstanding": 0,
        "currentPlan": null
    }
}

Modified at 2026-10-05 12:29:15

List distribution companies

Renew a TV subscription