---
title: "NIN"
method: POST
path: "/services/ng/nin"
tags: ["🇳🇬 Nigeria"]
---

# NIN

`POST /services/ng/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.

## Request body

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

## Response `200`

**OK**

The request was successful, and our system returned an expected response.

- object
  - `validation` object
    - `valid` boolean
  - `data` object
    - `nin` string — The Nigerian National Identification Number (NIN), a unique 11-digit identifier issued by the National Identity Management Commission (NIMC)
    - `first_name` string, name, nullable — The first name of a person
    - `middle_name` string, name, nullable — The middle name of a person
    - `last_name` string, name, nullable — The last name of a person
    - `dob` string, date, nullable — The date of birth of a person, formatted as “YYYY-MM-DD” according to ISO 8601
    - `phone` string, nullable — The phone number of a person or a company
    - `email` string, email, nullable — The email address of a person or a company
    - `gender` 'M' | 'F', nullable — The gender of a person. `M` indicates male; `F` indicates female
    - `residence_country` string, nullable — A residence country of an object. A two-letter country code according to ISO 3166-2
    - `profile_image` string, binary — A profile image of a person in base64 binary format
    - `address` object
      - `country` string, nullable — A country of an object. A two-letter country code according to ISO 3166-2
      - `state` string, nullable — A state of a person or a company
      - `district` string, nullable — The district (an area of a city) of an object
      - `address` string, nullable — An address (a street name, a building number, and a unit number) of a person or a company

## Other responses

- `400` — **Bad Request** Our system could not process the request due to invalid syntax, missing parameters, or incorrect data format. Check the request structure and try again.
- `402` — **Payment Required** Access to the requested resource is restricted until a payment is successfully processed. Ensure your account has a valid payment method or sufficient funds to complete this action.
- `404` — **Not Found** The requested resource does not exist or can’t be found in our system.
- `422` — **Unprocessable Content** Our system understands the request but can’t process it due to invalid fields in the request body.
- `500` — **Internal Server Error** This response indicates that our system encountered an unexpected condition that prevented it from fulfilling the request.
- `502` — **Bad Gateway** This response indicates that our system is unable to reach or communicate properly with an upstream server it relies on, the URL provided is incorrect, or a required token is missing from the request.

---

[API](https://skmtc.net/kycaid/apis/overview.md) · [All operations](https://skmtc.net/kycaid/apis/overview/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kycaid/overview/versions/971fdaeccced/schema)