Validate Meter Number

Developing

POST

/api/v1/public/validatemeter

Confirms a prepaid or postpaid electricity meter number with its distribution company and returns the registered customer name and address. The wallet is debited ₦80 by default, or the company's custom meter fee, whenever VTPass answers, even when the meter is invalid. Provider outages are not charged and results are not cached.

Request

Authorization

API Key

Add parameter in header

X-Api-Key

Example:

X-Api-Key: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Provider answered. Check data.isVerified, because a 200 does not mean the meter exists.

Bodyapplication/json

🟠400

🟠401

🔴500

🔴502

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v1/public/validatemeter' \
--header 'X-Api-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "discoCode": "IKEDC",
    "meterNo": "1111111111111",
    "customerType": "prepaid"
}'

Response Example

200 - Success

{
    "status": true,
    "message": "Operation successful.",
    "data": {
        "isVerified": true,
        "message": "Meter number verified successfully.",
        "detail": "TRANSACTION SUCCESSFUL",
        "responseCode": "000",
        "referenceId": "3f1c0a52-6d0e-4f3e-9a55-0f2f7a8b9c10",
        "transactionId": "9b2f0d6a1c8e4c0f8a7d3e5b6c1a2d4e",
        "verificationStatus": "verified",
        "data": {
            "meterNo": "1111111111111",
            "discoCode": "IKEDC",
            "discoName": "Ikeja Electric",
            "customerType": "prepaid",
            "customerName": "JOHN DOE",
            "address": "12 Admiralty Way, Lekki, Lagos",
            "businessUnit": "Lekki",
            "outstandingAmount": "0",
            "minimumPurchaseAmount": "900"
        },
        "billingInfo": {
            "wasCharged": true,
            "amount": "80",
            "currency": "NGN",
            "note": "Meter number validation charge"
        }
    }
}

Modified at 2026-10-13 19:14:01

Verify A Voter's Card

Validate TV Smartcard