Retrieve the identity details linked to a BVN when your approved workflow needs the registered profile.
₦100per resolved call
/v1/identity/bvn/details{
"bvn": "22222222220"
}{
"request_id": "req_01m4f8k2v9qyx7d3h6t1c5n0wa",
"verified": true,
"data": {
"bvn": "22222222220",
"first_name": "Amara",
"middle_name": "Chidinma",
"last_name": "Okafor",
"date_of_birth": "1990-04-17",
"gender": "female",
"phone_number": "08030000012",
"nationality": "NG"
}
}Request full details only when your use case needs them. Limit how much identity data you display, store and log.
The customer’s BVN, collected for an authorised purpose.
bvnThe registered details behind the BVN, such as name, date of birth, phone number and gender.
registered BVN holder detailsSend these in bvn with a test key and the sandbox returns the matching outcome every time. Only the records on file verify: any other value, or a changed name or date of birth, is not on record.
| Test value | Outcome | Billed |
|---|---|---|
22222222220 | Successful verification | ₦100 |
22222222221 | No matching identity | ₦100 |
22222222222 | Identity mismatch | ₦100 |
22222222223 | Upstream provider unavailable | Not billed |
22222222224 | Upstream provider timeout | Not billed |
22222222225 | Upstream provider error | Not billed |
Synthetic people and companies, with names from across Nigeria. Send a record exactly as listed for a verified answer.
| Record | bvn |
|---|---|
| Amara Okafor | 22222222220 |
| Oluwaseun Adeyemi | 22100000010 |
| Abubakar Bello | 22100000020 |
| Hauwa Jalo | 22100000030 |
| Ebiere Alagoa | 22100000040 |
| Ekaette Bassey | 22100000050 |
| Terver Iorliam | 22100000060 |
| Osaretin Igbinedion | 22100000070 |
Only the identity details this check needs, with notice.
Send an authenticated request from your backend.
Read the outcome and the details it returns.
Apply your product’s onboarding and risk policies.
Store the request_id under your own retention policy.
Keep identifiers and API keys out of the browser, URLs, analytics and logs. Collect only what this check needs, and keep the result only as long as your policy requires.
Read our data protection rulesCreate an account, make a test key and call any of the four services against the sandbox.