BVN Face Validation

Verify a BVN and perform face matching between a submitted face photo and the BVN holder's enrolled photo. Returns base64Image of the enrolled photo in the response. The submitted image is NOT stored by Truztcube.

POST/v1/bvn/face-validation

Authorization

api-key

x-api-key<token>

In: header

Header Parameters

X-Correlation-ID?string

Idempotency-Key?string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

number*string

BVN number (exactly 11 numeric digits).

image*string

Base64-encoded face photograph of the BVN holder. Required for face-validation only. Not persisted by Truztcube.

consentGranted*boolean

Explicit consent from the data subject.

consentReference*string

Reference identifying where consent was obtained.

Response Body

`application/json`

curl -X POST "https://example.com/v1/bvn/face-validation" \  -H "Content-Type: application/json" \  -d '{    "number": "22222222222",    "image": "/9j/4AAQSkZJRgABAQ...",    "consentGranted": true,    "consentReference": "CONSENT-REF-2024-001"  }'

{  "success": true,  "statusCode": 200,  "message": "Request processed successfully",  "timestamp": "2025-10-20T16:30:00.000Z",  "path": "/v1/auth/register",  "data": {    "verificationStatus": "VERIFIED",    "referenceId": {},    "verificationId": {},    "charged": true,    "chargeAmount": 0,    "verificationData": {      "firstName": {},      "lastName": {},      "middleName": {},      "dateOfBirth": {},      "gender": {},      "phoneNumber1": {},      "phoneNumber2": {},      "email": {},      "registrationDate": {},      "enrollmentBank": {},      "enrollmentBranch": {},      "nameOnCard": {},      "nationality": {},      "watchListed": {},      "residentialAddress": {},      "stateOfOrigin": {},      "stateOfResidence": {},      "lgaOfOrigin": {},      "lgaOfResidence": {},      "maritalStatus": {},      "levelOfAccount": {},      "base64Image": {},      "facialMatchScore": {},      "faceData": {        "confidence": 0,        "message": "string"      }    }  }}

Empty