Validate meter

X-API-Key

POST/electricity/validate-meter

Verify a meter before purchase. Use the returned customer details and amount limits on the purchase call. When the upstream provider reports it (e.g. BuyPower), meter_type may differ from your request (meter_type_corrected: true) and outstanding / outstanding_balance may be greater than 0 — customers can still proceed. VTPass and similar providers keep your requested meter_type and return outstanding: 0.

Language

curl -X POST "https://api.vendpower.ng/api/v1/electricity/validate-meter" \
  -H "X-API-Key: YOUR_X_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "meter_number": "12345678901",
    "disco_code": "IKDC",
    "meter_type": "PREPAID"
  }'

Authentication

Send your approved API key on every request. Keep it on your server only.

Header	Value	Required
X-API-Key	YOUR_X_API_KEY	Yes
Content-Type	application/json	Yes
Accept	application/json	Recommended

Authentication failures (401 / 403 / 429) are listed in Authentication.

Parameters

Body parameters

Name	Type	Required	Description
meter_number	string	Yes	Customer meter number
disco_code	string	Yes	e.g. `IKDC` from discos list
meter_type	string	Yes	`PREPAID` or `POSTPAID`

Responses

200 OK — Validated · 200 OK — Validated · type corrected + outstanding (BuyPower)

{
  "success": true,
  "message": "Meter validated successfully.",
  "data": {
    "customer_name": "JOHN DOE",
    "customer_address": "12 Example St",
    "meter_number": "12345678901",
    "disco_code": "IKDC",
    "meter_type": "PREPAID",
    "requested_meter_type": "PREPAID",
    "meter_type_corrected": false,
    "min_amount": 500,
    "max_amount": 100000,
    "outstanding": 0,
    "outstanding_balance": 0,
    "debt_repayment": 0,
    "validation_note": null
  }
}

Errors

Errors specific to this endpoint, in addition to common authentication and validation failures.

Code	HTTP	When
VALIDATION_FAILED	422	Meter / smartcard / customer could not be verified.
BILLER_NOT_FOUND	404	Unknown or inactive disco / biller for your API scope.