Skip to content

BVN with Face Verification

This endpoint allows you to verify the validity of a Bank Verification Number (BVN) along with a face biometric match.

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

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.
image string Yes A base64-encoded image string for face verification.

Sample Request

curl -X 'POST' \
  '{baseurl}/v1/api/verification/bvn-face' \
  -H 'accept: application/json' \
  -H 'x-api-key: {API-KEY}' \
  -H 'Content-Type: application/json' \
  -d '{
    "country": "NGA",
    "reference": "01223334444fgqdv455555",
    "identity": "67f6050e03418e0428005cea",
    "verificationLevel": "basic",
    "bvn": "12345678901",
    "image": "base64_encoded_image_string"
  }'

Sample Response

{
  "status": true,
  "responseCode": "00",
  "statusCode": "200",
  "message": "BVN with face verification successful",
  "data": {
    "firstName": "John",
    "lastName": "Doe",
    "middleName": "A.",
    "dateOfBirth": "1990-01-01",
    "phoneNumber": "+2348012345678",
    "gender": "Male"
  },
  "meta": {
    "statusCode": "200",
    "isValid": true,
    "timeStamp": "Wed Apr 23 2025 07:31:36 GMT+0000 (Coordinated Universal Time)"
  }
}