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.
verificationLevel string Yes The level of verification to perform (e.g., "basic", "extended").
bvn string Yes The Bank Verification Number to verify.
customer string No ID of the customer (optional).
verificationGroup string No ID of the verification group (optional).

Sample Request

curl -X 'POST' \
  'https://api.sourceid.tech/v1/api/verification/bvn' \
  -H 'accept: application/json' \
  -H 'x-api-key: {API-KEY}' \
  -H 'Content-Type: application/json' \
  -d '{
  "country": "NGA",
  "reference": "0122333wqaqd4444555355",
  "verificationLevel": "basic",
  "bvn": "",
  "customer": "6791457be570f7f292f1fe23",
  "verificationGroup": "6791457be570f7f292f1fe23"
}'

Sample Response

{
    "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)"
    }
}