DOJAH PARITY/api/v1/kyc/bvn

Bank Verification Number (BVN)

Verify an 11-digit BVN against the national database. Verixa provides 100% Dojah endpoint parity across validation matching, full demographics, advance branch tier lookups, and biometric selfie face verification.

STANDARD LOOKUP95 NGX (₦95.00)

ADVANCE / BIOMETRIC125 - 150 NGX

SMART CACHE HIT38 NGX (₦38.00)

LATENCY (CACHE / LIVE)<15ms / ~140ms

Available Endpoints & Tiers

1. Field Validation & MatchGET /api/v1/kyc/bvn?bvn=...

Validates if user-supplied name and DOB match BVN records.

2. Full Profile LookupGET /api/v1/kyc/bvn/full?bvn=...

Returns customer names, verified phone number, gender, and DOB.

3. Advance ProfileGET /api/v1/kyc/bvn/advance?bvn=...

Includes enrollment branch, bank code, and account level tier.

4. Selfie Face VerificationPOST /api/v1/kyc/bvn/verify

Performs facial matching between live selfie and government photo.

Query Parameters (GET /api/v1/kyc/bvn)

Field	Type	Required	Description
bvn	string	Required	The 11-digit Bank Verification Number.
first_name	string	Optional	Customer first name for verification matching.
last_name	string	Optional	Customer surname / last name for match scoring.
dob	string	Optional	Date of birth in `YYYY-MM-DD` format.

Example Request & Response (Dojah Parity)

cURL Request (Full Profile)

curl -X GET "https://api.verixaid.com/api/v1/kyc/bvn/full?bvn=22123456789" \
  -H "Authorization: vrx_live_9f83a8f1e2b4c6d8_a1b2c3d4..." \
  -H "AppId: app_6a7b8c9d0e1f" \
  -H "Content-Type: application/json"

HTTP 200 OK Response

{
  "status": "success",
  "entity": {
    "bvn": "22123456789",
    "first_name": "JOHN",
    "last_name": "MUSA",
    "middle_name": "DOE",
    "date_of_birth": "1997-05-16",
    "phone_number1": "08012345678",
    "gender": "Male",
    "enrollment_bank": "GTB",
    "enrollment_branch": "Ikeja",
    "level_of_account": "LEVEL 2"
  },
  "billed_amount": 50,
  "cached": false,
  "meta": {
    "request_id": "vx_req_8f19a02d",
    "service": "bvn",
    "latency_ms": 142
  }
}

BVN Face Match Verification (POST /api/v1/kyc/bvn/verify)

Pass the user's live camera selfie base64 image along with their BVN to cross-reference facial landmarks against the NIBSS facial database with liveness detection.

cURL Request (Selfie Match)

curl -X POST https://api.verixaid.com/api/v1/kyc/bvn/verify \
  -H "Authorization: vrx_live_9f83a8f1..." \
  -H "AppId: app_6a7b8c9d0e1f" \
  -H "Content-Type: application/json" \
  -d '{
    "bvn": "22123456789",
    "selfie_image": "/9j/4AAQSkZJRgABAQ...",
    "threshold": 90
  }'