API ReferenceBVN Verification
BVN Advance Lookup
Verify a BVN and retrieve the full biographic record (address, state of origin, LGA, marital status, etc.). Requires a valid Idempotency-Key header for live-mode keys.
POST
/v1/bvn/advanceAuthorization
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.
Response Body
application/json
curl -X POST "https://example.com/v1/bvn/advance" \ -H "Content-Type: application/json" \ -d '{ "number": "22222222222", "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": {} } }}Empty
Empty
Empty
Empty
BVN Basic Lookup
Verify a BVN number and retrieve basic identity data (name, date of birth, gender, phone). Requires a valid Idempotency-Key header for live-mode API keys to prevent duplicate charges.
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.