Skip to main content
🪪

KYC / KYB

Verify individuals and businesses before onboarding. Run NIN and BVN checks against government registries, compare facial biometrics, and validate business registration numbers — all in one place.

🪪 NIN verification🛡️ BVN via NIBSS iGree🤳 Face biometrics🏢 CAC RC number

BVN Verification Flow​

BVN checks run through the NIBSS iGree Consent Layer and require three sequential calls. The OTP is delivered by NIBSS directly to the customer's registered contact.

1
Get Auth Methods

Submit the customer's BVN. Returns the masked phone number and/or email address registered against it, plus a requestId. Save the requestId — it is required in step 2.

2
Verify Auth Method

Select the OTP delivery channel (phone or email) using the requestId from step 1. NIBSS dispatches the one-time passcode to the customer's chosen contact.

3
Fetch BVN Details

Submit the OTP and requestId to complete verification. On success, returns the full BVN profile — personal details, address, NIN linkage, and a base64-encoded face image.

Important Notes​

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>.

NIN verification response format

The NIN endpoint returns per-field match results (match, partial_match, no_match) rather than a single pass/fail. Validate each field individually in your onboarding logic.

Endpoints​

Business KYB
Individual KYC
BVN Verification (3-step flow)