# NIN

The Nigeria NIN (National Identification Number) service provides a method for checking and confirming person idenitity using their NIN. It utilizes the provided 11-digit NIN to query the official national database. The service returns a detailed response including the NIN holder's registered identity data (full name, date of birth, address, and gender) upon a successful match.

Endpoint: POST /services/ng/nin
Version: 1.0
Security: your_api_key

## Request fields (application/json):

  - `nin_number` (string)
    The Nigerian National Identification Number (NIN), a unique 11-digit identifier issued by the National Identity Management Commission (NIMC)

## Response 200 fields (application/json):

  - `validation` (object)

  - `validation.valid` (boolean)
    Example: true

  - `data` (object)

  - `data.nin` (string)
    The Nigerian National Identification Number (NIN), a unique 11-digit identifier issued by the National Identity Management Commission (NIMC)

  - `data.first_name` (string,null)
    The first name of a person

  - `data.middle_name` (string,null)
    The middle name of a person

  - `data.last_name` (string,null)
    The last name of a person

  - `data.dob` (string,null)
    The date of birth of a person, formatted as “YYYY-MM-DD” according to ISO 8601

  - `data.phone` (string,null)
    The phone number of a person or a company

  - `data.email` (string,null)
    The email address of a person or a company

  - `data.gender` (string,null)
    The gender of a person. M indicates male; F indicates female
    Enum: "M", "F"

  - `data.residence_country` (string,null)
    A residence country of an object. A two-letter country code according to ISO 3166-2

  - `data.profile_image` (string)
    A profile image of a person in base64 binary format

  - `data.address` (object)

  - `data.address.country` (string,null)
    A country of an object. A two-letter country code according to ISO 3166-2

  - `data.address.state` (string,null)
    A state of a person or a company

  - `data.address.district` (string,null)
    The district (an area of a city) of an object

  - `data.address.address` (string,null)
    An address (a street name, a building number, and a unit number) of a person or a company

## Response 400 fields (application/json):

  - `type` (string)
    Example: "bad_request"

  - `errors` (array)

## Response 404 fields (application/json):

  - `validation` (object)

  - `validation.valid` (boolean)

  - `data` (object)

  - `data.nin` (string)
    The Nigerian National Identification Number (NIN), a unique 11-digit identifier issued by the National Identity Management Commission (NIMC)

## Response 500 fields (application/json):

  - `type` (string)
    Example: "internal_server"

  - `errors` (array)