Skip to main content
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.

​
Body

​
meterNumber
string
required
The electricity meter number.
​
provider
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

StatusBodyWhen
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.
Verification is rate limited to 10 attempts per hour per caller.