> ## Documentation Index
> Fetch the complete documentation index at: https://sigma-docs.pastelhq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# NIN Search

> Look up individual identity details using a National Identification Number (NIN).

### What is NIN?

The National Identification Number (NIN) is a unique 11-digit identifier issued by the National Identity Management Commission (NIMC) to every Nigerian citizen and legal resident. It serves as a primary means of identity verification across government and private sector services.

### How it Works

Send a POST request to `/api/v1/kyc/nin` with the individual's NIN in the request body. The API returns verified biographical data, contact information, a base64-encoded passport photo, and next-of-kin details from the NIMC registry.

```bash theme={null}
curl --location 'https://sigmacdd.sabipay.com/api/v1/kyc/nin' \
--header 'apiKey: {{apiKey}}' \
--header 'apiSecret: {{apiSecret}}' \
--header 'Content-Type: application/json' \
--data '{
    "idNumber": "98864126516"
}'
```

### Request

| Field      | Type   | Required | Description                                 |
| ---------- | ------ | -------- | ------------------------------------------- |
| `idNumber` | string | Yes      | The 11-digit National Identification Number |

### Response Fields

A successful response returns the following data:

| Field              | Type   | Description                   |
| ------------------ | ------ | ----------------------------- |
| `idNumber`         | string | The NIN                       |
| `firstName`        | string | First name                    |
| `lastName`         | string | Last name                     |
| `middleName`       | string | Middle name                   |
| `dateOfBirth`      | string | Date of birth (YYYY-MM-DD)    |
| `gender`           | string | Gender                        |
| `phoneNumber`      | string | Phone number                  |
| `address`          | string | Residential address           |
| `photo`            | string | Base64-encoded passport photo |
| `nationality`      | string | Nationality                   |
| `maritalStatus`    | string | Marital status                |
| `employmentStatus` | string | Employment status             |
| `educationLevel`   | string | Education level               |
| `profession`       | string | Profession                    |
| `religion`         | string | Religion                      |
| `birthCountry`     | string | Country of birth              |
| `birthState`       | string | State of birth                |
| `residenceState`   | string | State of residence            |
| `residenceLga`     | string | LGA of residence              |
| `residenceTown`    | string | Town of residence             |
| `originState`      | string | State of origin               |
| `originLga`        | string | LGA of origin                 |

### Next-of-Kin Fields

The NIN response also includes next-of-kin information:

| Field           | Type   | Description             |
| --------------- | ------ | ----------------------- |
| `nokFirstName`  | string | Next of kin first name  |
| `nokMiddleName` | string | Next of kin middle name |
| `nokSurname`    | string | Next of kin surname     |
| `nokAddress`    | string | Next of kin address     |
| `nokLga`        | string | Next of kin LGA         |
| `nokState`      | string | Next of kin state       |
| `nokTown`       | string | Next of kin town        |
| `nokPostcode`   | string | Next of kin postcode    |

<Note>
  Fields may return `null` if the data is not available in the registry. For the full API specification, see the [NIN Search API reference](/api-reference/kyc/endpoint/nin-search).
</Note>