curl -X POST https://api.vouchmark.com/v1/verify-utility-bill/manual \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"meterNumber":"0123456789","provider":"IKEJA"}'
{
"success": true,
"billInfo": {
"meterNumber": "0123456789",
"provider": "IKEJA",
"billDate": ""
},
"verificationResult": {
"status": true,
"address": "14 Marina Road, Lagos",
"provider": "IKEJA",
"meterNumber": "0123456789"
}
}
Verifications
Verify utility bill (manual)
Verify an electricity meter directly from a meter number and provider.
POST
/
v1
/
verify-utility-bill
/
manual
curl -X POST https://api.vouchmark.com/v1/verify-utility-bill/manual \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"meterNumber":"0123456789","provider":"IKEJA"}'
{
"success": true,
"billInfo": {
"meterNumber": "0123456789",
"provider": "IKEJA",
"billDate": ""
},
"verificationResult": {
"status": true,
"address": "14 Marina Road, Lagos",
"provider": "IKEJA",
"meterNumber": "0123456789"
}
}
Verify an electricity meter without uploading a bill. Supply the meter number and the provider code and the meter is verified with the provider. The body is JSON.
Verification is rate limited to 10 attempts per hour per caller.
Body
string
required
The electricity meter number.
string
required
The provider code. One of
ABUJA, KADUNA, JOS, PH, IBADAN, IKEJA, EKO, ENUGU, KANO.curl -X POST https://api.vouchmark.com/v1/verify-utility-bill/manual \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"meterNumber":"0123456789","provider":"IKEJA"}'
Response
billInfo.billDate is returned empty for manual checks since no bill is read.
{
"success": true,
"billInfo": {
"meterNumber": "0123456789",
"provider": "IKEJA",
"billDate": ""
},
"verificationResult": {
"status": true,
"address": "14 Marina Road, Lagos",
"provider": "IKEJA",
"meterNumber": "0123456789"
}
}
Errors
| Status | Body | When |
|---|---|---|
400 | { "success": false, "error": "Request body is empty. Please provide meterNumber and provider." } | The body was empty. |
400 | { "success": false, "error": "meterNumber is required." } | meterNumber missing. |
400 | { "success": false, "error": "provider is required." } | provider missing. |
400 | { "success": false, "error": "Invalid provider. Valid providers are: ABUJA, KADUNA, JOS, PH, IBADAN, IKEJA, EKO, ENUGU, KANO" } | provider not recognised. |
500 | { "success": false, "error": "An error occurred during manual verification." } | Unexpected error. |