NIN verification
Check a person using their 11 digit National Identification Number (NIN).
Request
POST /v1/verifications/nin
{
"nin": "12345678901",
"reference": "your-own-reference-123"
}Response
200 OK
{
"status": "success",
"data": {
"id": "vrf_8f2a91",
"type": "nin",
"verified": true,
"nin": "123*****901",
"first_name": "Adaeze",
"middle_name": "Chiamaka",
"last_name": "Okafor",
"date_of_birth": "12-03-1994",
"gender": "female",
"marital_status": "single",
"phone": "08000000000",
"email": "[email protected]",
"residence": {
"address": "12 Sample Street",
"lga": "Ikeja",
"state": "Lagos",
"status": "birth"
},
"charged": 100
}
}You are only charged when verified is true.
first_name, last_name, date_of_birth and gender are always there. Every other detail (middle_name, marital_status, nationality, phone, phone_2, email, and the groups residence, origin, birth and next_of_kin) appears only when the official record has it, so check for a field before you use it.
