Retrieve the registered identity details linked to a NIN for an approved verification flow.
₦100per resolved call
/v1/identity/nin/details{
"nin": "11111111110"
}{
"request_id": "req_01m4f8k2v9qyx7d3h6t1c5n0wa",
"verified": true,
"data": {
"nin": "11111111110",
"first_name": "Amara",
"middle_name": "Chidinma",
"last_name": "Okafor",
"date_of_birth": "1990-04-17",
"gender": "female",
"phone_number": "08030000012",
"nationality": "NG"
}
}Use a full-details lookup only when it is necessary for your workflow, and set clear rules for access and retention.
The customer’s NIN, collected for an authorised purpose.
ninThe registered details behind the NIN, such as name, date of birth, phone number and address.
registered NIN holder detailsSend these in nin 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 |
|---|---|---|
11111111110 | Successful verification | ₦100 |
11111111111 | No matching identity | ₦100 |
11111111112 | Identity mismatch | ₦100 |
11111111113 | Upstream provider unavailable | Not billed |
11111111114 | Upstream provider timeout | Not billed |
11111111115 | 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 | nin |
|---|---|
| Amara Okafor | 11111111110 |
| Oluwaseun Adeyemi | 11100000010 |
| Abubakar Bello | 11100000020 |
| Hauwa Jalo | 11100000030 |
| Ebiere Alagoa | 11100000040 |
| Ekaette Bassey | 11100000050 |
| Terver Iorliam | 11100000060 |
| Osaretin Igbinedion | 11100000070 |
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.