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 verification via the NIBSS iGree consent flow, or compare facial images with a liveness check.

🪪 NIN — NIMC registry🛡️ BVN — NIBSS iGree🤳 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 Verification
3-step · NIBSS iGree
Verifies a Bank Verification Number via the NIBSS iGree Consent Layer. OTP delivery is handled entirely by NIBSS — no direct contact with the customer's details.
  • Step 1 — Get Auth Methods: initiate flow, receive requestId
  • Step 2 — Verify Auth Method: select OTP channel
  • Step 3 — Fetch BVN Details: submit OTP, receive full profile + face image
🤳
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>.