DOJAH PARITY/api/v1/kyc/nin

National Identification Number (NIN)

Verify an 11-digit NIN against the NIMC database. Verixa provides 100% Dojah endpoint parity across basic demographics, advance records with portraits and addresses, premium tiers, NIMC slips, and live biometric face matching.

BASIC & ADVANCE NIN125 NGX (₦125.00)
PREMIUM / BIOMETRIC150 NGX
SMART CACHE HIT50 NGX (₦50.00)
LATENCY (CACHE / LIVE)<15ms / ~160ms

Available Endpoints & Tiers

1. Basic NIN LookupGET /api/v1/kyc/nin?nin=...

Returns full name, gender, phone number, and date of birth.

2. Advance NIN LookupGET /api/v1/kyc/nin/advance?nin=...

Adds residence address, state of origin, next-of-kin, and base64 portrait.

3. Premium NINGET /api/v1/kyc/nin/premium?nin=...

Includes religion, profession, and digital signature records.

4. NIN Slip RecordGET /api/v1/kyc/nin/nin_slip?nin=...

Resolves official printable NIMC slip data with tracking ID.

5. NIN Selfie Face VerificationPOST /api/v1/kyc/nin/verify

Matches live user selfie against the government NIMC identity image.

Query Parameters (GET /api/v1/kyc/nin/advance)

FieldTypeRequiredDescription
ninstringRequiredThe 11-digit National Identity Number.

Example Request & Response (Advance)

cURL Request (Advance Profile)
curl -X GET "https://api.verixaid.com/api/v1/kyc/nin/advance?nin=70123456789" \
  -H "Authorization: vrx_live_9f83a8f1e2b4c6d8_a1b2c3d4..." \
  -H "AppId: app_6a7b8c9d0e1f" \
  -H "Content-Type: application/json"
HTTP 200 OK Response
{
  "status": "success",
  "entity": {
    "nin": "70123456789",
    "tracking_id": "T09281729481",
    "firstname": "JOHN",
    "surname": "ADAMU",
    "middlename": "DOE",
    "gender": "MALE",
    "birthdate": "1990-01-01",
    "telephoneno": "08012345678",
    "photo": "iVBORw0KGgoAAAANSUhEUgAA...",
    "signature": "data:image/png;base64,...",
    "residence_state": "Lagos",
    "residence_lga": "Ikeja",
    "residence_address_line_1": "12, Example Crescent, Ikeja",
    "nok_firstname": "JANE",
    "nok_lastname": "ADAMU"
  },
  "billed_amount": 100,
  "cached": false,
  "meta": {
    "request_id": "vx_req_4f92a10c",
    "service": "nin_advance",
    "latency_ms": 168
  }
}

NIN Face Match Verification (POST /api/v1/kyc/nin/verify)

Verify an applicant's identity with biometric certainty by matching their live captured selfie against the NIMC registry photograph.

cURL Request (Selfie Match)
curl -X POST https://api.verixaid.com/api/v1/kyc/nin/verify \
  -H "Authorization: vrx_live_9f83a8f1..." \
  -H "AppId: app_6a7b8c9d0e1f" \
  -H "Content-Type: application/json" \
  -d '{
    "nin": "70123456789",
    "selfie_image": "/9j/4AAQSkZJRgABAQ...",
    "threshold": 90
  }'