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

# Advanced NIN Lookup with Extra Data

> Get richer NIN verification. Same identity data plus additional fields for compliance and risk when you need more than basics.

### Lookup NIN Advance

### Request

```http [GET] theme={null}
{{baseURL}}/api/v1/kyc/nin/advance
```

### Query parameters

| Parameter | Type   | Description | Required |
| --------- | ------ | ----------- | -------- |
| nin \*    | string | A valid nin | required |

### Sample response

```json [200] theme={null}

{
    "entity": {
        "nin": "1*****78910",
        "first_name": "John",
        "last_name": "Musa",
        "middle_name": "Doe",
        "date_of_birth": "1909-01-11",
        "phone_number": "081123456798",
        "photo": "/9j/4AAQSz\nQBKtKKaOgp460hjlpw4pmcGnA8Uhj6Mc0g6UCg...",
        "gender": "Male",
        "employment_status": "unemployed",
        "marital_status": "single",
        "birth_country": "nigeria",
        "birth_lga": "Ikeja",
        "birth_state": "Lagos",
        "educational_level": "tertiary",
        "maiden_name": "",
        "nspoken_lang": "YORUBA",
        "profession": "STUDENT",
        "religion": "christianity",
        "residence_address_line_1": "2, ANON STREET",
        "residence_address_line_2": "",
        "residence_status": "birth",
        "residence_town": "",
        "residence_lga": "Ikeja West",
        "residence_state": "Ikeja",
        "ospoken_lang": "ENGLISH",
        "origin_lga": "Ikeja",
        "origin_place": "",
        "origin_state": "Lagos",
        "height": "171",
        "p_first_name": "",
        "p_middle_name": "",
        "p_last_name": "",
        "tax_id": "211111111111111111",
        "tax_residency": "Lagos State"
    }
}
```

### Response Fields

| Field                              | Type   | Description                                 |
| ---------------------------------- | ------ | ------------------------------------------- |
| entity                             | object | Contains the NIN holder's identity details  |
| entity.nin                         | string | National Identification Number              |
| entity.first\_name                 | string | First name of the NIN holder                |
| entity.last\_name                  | string | Last name of the NIN holder                 |
| entity.middle\_name                | string | Middle name of the NIN holder               |
| entity.date\_of\_birth             | string | Date of birth in YYYY-MM-DD format          |
| entity.phone\_number               | string | Phone number linked to the NIN              |
| entity.photo                       | string | Base64-encoded photograph of the NIN holder |
| entity.gender                      | string | Gender of the NIN holder                    |
| entity.employment\_status          | string | Employment status of the NIN holder         |
| entity.marital\_status             | string | Marital status of the NIN holder            |
| entity.birth\_country              | string | Country of birth                            |
| entity.birth\_lga                  | string | Local Government Area of birth              |
| entity.birth\_state                | string | State of birth                              |
| entity.educational\_level          | string | Highest level of education attained         |
| entity.maiden\_name                | string | Maiden name, if applicable                  |
| entity.nspoken\_lang               | string | Native spoken language                      |
| entity.profession                  | string | Profession or occupation                    |
| entity.religion                    | string | Religious affiliation                       |
| entity.residence\_address\_line\_1 | string | Primary residential address line            |
| entity.residence\_address\_line\_2 | string | Secondary residential address line          |
| entity.residence\_status           | string | Residential status (e.g., birth, rental)    |
| entity.residence\_town             | string | Town of residence                           |
| entity.residence\_lga              | string | Local Government Area of residence          |
| entity.residence\_state            | string | State of residence                          |
| entity.ospoken\_lang               | string | Other spoken language                       |
| entity.origin\_lga                 | string | Local Government Area of origin             |
| entity.origin\_place               | string | Place of origin                             |
| entity.origin\_state               | string | State of origin                             |
| entity.height                      | string | Height in centimeters                       |
| entity.p\_first\_name              | string | Next-of-kin first name                      |
| entity.p\_middle\_name             | string | Next-of-kin middle name                     |
| entity.p\_last\_name               | string | Next-of-kin last name                       |
| entity.tax\_id                     | string | Tax Identification Number                   |
| entity.tax\_residency              | string | State of tax residency                      |

### Test Credentials for Sandbox

Kindly use this Test NIN in sandbox Environment

nin = `70123456789`