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.