Skip to main content
🪪

Individual KYC

Verify individuals before onboarding using government-backed registries and biometrics. Run NIN lookups against the NIMC registry, complete BVN Identity or BVN Accounts verification via the NIBSS iGree consent flow, or compare facial images with a liveness check.

🪪 NIN — NIMC registry📄 BVN Identity🏦 BVN Accounts🤳 Face biometrics

Verification Methods​

🪪
NIN Verification
POST · Single step
Cross-checks a National Identification Number against the NIMC registry. Supply the customer's personal details and receive per-field match results.
  • Returns match / partial_match / no_match per field
  • Single API call — no multi-step flow
📄
BVN Identity
3-step · NIBSS iGree
Verifies a customer's core demographic identity via the NIBSS iGree Consent Layer. OTP delivery is handled entirely by NIBSS.
  • Step 1 — Get Auth Methods: initiate flow, receive requestId
  • Step 2 — Verify Auth Method: select OTP channel
  • Step 3 — Fetch BVN Identity: submit OTP, receive profile + face image
🏦
BVN Accounts
3-step · NIBSS iGree
Retrieves all bank accounts tied to a customer's BVN via the NIBSS iGree Consent Layer. OTP delivery is handled entirely by NIBSS.
  • Step 1 — Get Auth Methods: initiate flow, receive requestId
  • Step 2 — Verify Auth Method: select OTP channel
  • Step 3 — Fetch BVN Accounts: submit OTP, receive profile + linked accounts
🤳
Face Verification
POST · multipart/form-data
Compares two facial images and returns a similarity score, image quality rating, and passive liveness check result.
  • referenceImage — face from BVN record (data.face_image)
  • comparisonImage — live capture at onboarding
  • Accepts multipart/form-data, not JSON
Bearer token required on all endpoints

Every endpoint in this section requires a valid Bearer token. Obtain one from the Access Token endpoint and pass it as Authorization: Bearer <token>.