Verify BVN
Verifies a BVN against the NIBSS (Nigerian Interbank Settlement System) database and checks if the name matches the record on file.
Privacy: The full BVN and date of birth are never returned. The response
shows only masked values (e.g. ****5678) to comply with NDPR data minimisation rules.
Use cases: Verifying the identity of a customer before opening an account for them, or confirming a director’s identity during KYB.
Requires X-Signature header (HMAC-SHA256 of request body).
Authorizations
Your API key, formatted as: ApiKey ubn_sb_your_key_here
- Sandbox keys start with
ubn_sb_ - Production keys start with
ubn_pk_ - Never use production keys during testing, they will charge real money
Headers
A UUID v4 you generate to trace this request through our systems. If you don't provide one, we generate it for you. Always include it in support requests, it helps us find your request in logs.
"7f3a9c21-4e8b-4a12-b6d1-3c8a7f2e1b09"
Body
Response
BVN verification result
Standard response wrapper for all successful API calls

