Verify BVN

Verify a Bank Verification Number (BVN) instantly.

Request

Provide the BVN and your API key to authenticate the request.

Parameters

bvnStringRequired

The 11-digit Bank Verification Number to verify.

x-api-keyHeaderRequired

Your Amadioha secret API key for authorization.

curl -X POST https://amadioha.io/api/v1/identity/bvn/verify \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_api_key_here" \
  -d '{
  "bvn": "22612216066"
}'

Response

The structured payload returned upon successful verification.

Upon successful verification, Amadioha returns the complete identity entity.

Clean Image URLs

Notice how the image field is a standard web URL instead of a cumbersome base64 string. You can confidently place this URL directly in an HTML <img src="..."> tag without needing an API key.

Success Response
{
  "entity": {
    "bvn": "22612216055",
    "first_name": "JOHN",
    "last_name": "OLADELE",
    "middle_name": "OLUWATOMIWA",
    "gender": "Male",
    "date_of_birth": "2010-02-12",
    "phone_number1": "09061811367",
    "image": "https://amadioha.io/api/v1/identity/image/385765b5-a114-43bd-b0ee-cd22a038e21a.jpeg",
    "phone_number": "09061811367"
  }
}