Unified Identity Verification
Securely verify identities across African borders using our sovereign data rails. Integrate biometric, corporate, and financial records in a single request.
BVN Verification
Securely verify Bank Verification Numbers (BVN) against the NIBSS central database. Our API provides two tiers of access: Basic for identity confirmation and Premium for full KYC profile retrieval including biometric images.
Real-time Pull
Direct connection to sovereign financial rails with < 1.5s latency.
Tiered Data
Choose between lightweight verification or full profile disclosure.
Audit-Ready
Every request is logged with a unique Request ID for compliance reporting.
/v1/ng/bvn/basic/
Basic Verification
Use this endpoint when you only need to confirm that a BVN belongs to a specific individual. It returns core biographical data without images.
- Response includes Names, DOB, and Phone.
{
"bvn": "22123456789"
}
/v1/ng/bvn/premium/
Premium Verification
The Premium endpoint retrieves the complete NIBSS record, including the Base64 encoded profile image, residential address, and enrollment details.
Required for biometric face-matching workflows.
{
"status": "success",
"data": {
"bvn": "22123456789",
"image": "data:image/jpeg;base64,...",
"enrollment_bank": "GTBank",
"address": "No. 5 Old GRA, Gboko"
}
}
Common Error Scenarios
NOT_FOUND
The BVN provided does not exist in the NIBSS central database. Double check for transcription errors.
INSUFFICIENT_FUNDS
Your organization's wallet balance is below the threshold required for this request.