Verify National Identification Number (NIN)

This endpoint allows you to verify the validity of a National Identification Number (NIN).

Endpoint: POST {baseurl}/v1/api/verification/nin

Request Body

Parameter	Type	Required	Description
country	string	Yes	The country code (e.g., "NGA" for Nigeria).
reference	string	Yes	A unique reference for the verification request.
identity	string	Yes	A unique identifier for the verification request.
verificationLevel	string	No	The level of verification to perform (e.g., "basic", "Extended").
ninIdentifier	string	Yes	The National Identification Number to verify.
type	string	Yes	The type of identifier (e.g., "NIN", "vNIN").

Sample Request

curl

curl -X POST "{baseurl}/v1/api/verification/nin" \
-H "Content-Type: application/json" \
-H "x-api-key: {API-KEY}" \
-d '{
    "country": "NGA",
    "reference": "0122333444455555",
    "identity": "6791457be570f7f292f1fe23",
    "verificationLevel": "basic",
    "ninIdentifier": "1234567890",
    "type": "NIN"
}'

Sample Response

BasicExtended

{
  "status": true,
  "responseCode": "00",
  "statusCode": "200",
  "message": "NIN verification successful",
  "data": {
    "names": {
      "firstName": "",
      "lastName": "",
      "middleName": "",
      "title": null
    },
    "personalData": {
      "dateOfBirth": "",
      "gender": "",
      "religion": null,
      "height": null,
      "educationLevel": null,
      "employmentStatus": null
    },
    "address": {
      "residenceAddress": "",
      "residenceTown": null,
      "residenceLga": null,
      "residenceState": "",
      "residenceStatus": null
    },
    "contact": {
      "phoneNumber": ""
    },
    "identification": {
      "nin": "",
      "vnin": null,
      "centralId": null,
      "userId": null,
      "trackingId": ""
    },
    "origin": {
      "birthCountry": "",
      "birthState": null,
      "birthLga": null,
      "originState": "",
      "originLga": "",
      "originPlace": null
    },
    "documents": {
      "photo":"",
      "signature": null
    },
    "nextOfKin": [
      {}
    ],
    "parents": {
      "names": {
        "firstName": null,
        "lastName": null,
        "middleName": null
      }
    }
  },
  "meta": {
    "statusCode": "200",
    "isValid": true,
    "timeStamp": "Wed Apr 23 2025 06:10:08 GMT+0000 (Coordinated Universal Time)"
  }
}

{
  "status": true,
  "responseCode": "00",
  "statusCode": "200",
  "message": "NIN verification successful",
  "data": {
    "names": {
      "firstName": "",
      "lastName": "",
      "middleName": "",
      "title": null
    },
    "personalData": {
      "dateOfBirth": "",
      "gender": "",
      "religion": null,
      "height": null,
      "educationLevel": null,
      "employmentStatus": null
    },
    "address": {
      "residenceAddress": "",
      "residenceTown": null,
      "residenceLga": null,
      "residenceState": "",
      "residenceStatus": null
    },
    "contact": {
      "phoneNumber": ""
    },
    "identification": {
      "nin": "",
      "vnin": null,
      "centralId": null,
      "userId": null,
      "trackingId": ""
    },
    "origin": {
      "birthCountry": "",
      "birthState": null,
      "birthLga": null,
      "originState": "",
      "originLga": " ",
      "originPlace": null
    },
    "documents": {
      "photo": "",
      "signature": null
    },
    "nextOfKin": [
      {}
    ],
    "parents": {
      "names": {
        "firstName": null,
        "lastName": null,
        "middleName": null
      }
    }
  },
  "meta": {
    "statusCode": "200",
    "isValid": true,
    "timeStamp": "Wed Apr 23 2025 05:37:35 GMT+0000 (Coordinated Universal Time)"
  }
}