Verify Bank Verification Number (BVN)

This endpoint allows you to verify the validity of a Bank Verification Number (BVN).

Endpoint: POST {baseurl}/v1/api/verification/bvn

Request Body

Parameter	Type	Required	Description
`country`	`string`	Yes	The country code (e.g., "NGA" for Nigeria).
`reference`	`string`	Yes	A unique reference for the verification request.
`identity`	`string`	Yes	A unique identifier for the user.
`verificationLevel`	`string`	Yes	The level of verification to perform (e.g., "basic", "Extended").
`bvn`	`string`	Yes	The Bank Verification Number to verify.

Sample Request

curl

curl -X POST "{baseurl}/v1/api/verification/bvn" \
-H "Content-Type: application/json" \
-H "x-api-key: {API-KEY}" \
-d '{
    "country": "NGA",
    "reference": "0122333wqaqd4444555355",
    "identity": "67f6050e03418e0428005cea",
    "verificationLevel": "basic",
    "bvn": ""
}'

Sample Response

BasicExtended

{
    "status": true,
    "responseCode": "00",
    "statusCode": "200",
    "message": "BVN verification successful",
    "data": {
      "firstName": " ",
      "lastName": "",
      "middleName": "",
      "dateOfBirth": ""
    },
    "meta": {
      "statusCode": "200",
      "isValid": true,
      "timeStamp": "Wed Apr 23 2025 07:13:01 GMT+0000 (Coordinated Universal Time)"
    }
}

{
    "status": true,
    "responseCode": "00",
    "statusCode": "200",
    "message": "BVN verification successful",
    "data": {
        "firstName": " ",
        "lastName": "",
        "middleName": "",
        "dateOfBirth": "",
        "gender": "",
        "title": null,
        "maritalStatus": "",
        "watchListed": "",
        "levelOfAccount": null,
        "bvn": "",
        "phoneNumber1": "",
        "phoneNumber2": null,
        "enrollmentBank": null,
        "enrollmentBranch": null,
        "email": "",
        "lgaOfOrigin": "",
        "lgaOfResidence": null,
        "nameOnCard": null,
        "nationality": null,
        "residentialAddress": null,
        "stateOfOrigin": "",
        "stateOfResidence": null,
        "base64Image": ""
    },
    "meta": {
        "statusCode": "200",
        "isValid": true,
        "timeStamp": "Wed Apr 23 2025 07:14:01 GMT+0000 (Coordinated Universal Time)"
    }
}