> ## 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.

# Lookup NIN Slip

> Fetch customer details and NIN slip data using the National Identification Number. Returns identity and slip information from NIMC.

### Lookup NIN Slip

### Request

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

### 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/4AAQSkZJRgABAgAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgKDBQNDAsLDBkSEw8Ux60gooqWUhJvurSL0oopDNHSbiaC/jeGaSNwwwyMQR+VfUXhmaWbw7ZySyPJI3VmYkn8aKKykM2j1NUdSgintGWWJJF9HUGiilETPmHxdFHBr1ykMaRqAflQYHX2rl4+Sc0UVoB//Z",
        "gender": "Male",
        "email": "",
        "employment_status": "unemployed",
        "marital_status": "single",
        "birth_country": "nigeria",
        "birth_lga": "Anon",
        "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": "Lagos West",
        "residence_state": "Lagos",
        "ospoken_lang": "ENGLISH",
        "origin_lga": "EFON",
        "origin_place": "",
        "origin_state": "Lagos",
        "height": "171",
        "p_first_name": "",
        "p_middle_name": "",
        "p_last_name": "",
        "nin_id": "JVBERi0xLjQKMSAwIG9iago8PA/9j/4AAQSkZJRgABAgAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgKDBQNDAsLDBkSEw8Ux60gooqWUhJvurSL0oopDNHSbiaC/jeGaSNwwwyMQR+VfUXhmaWbw7ZySyPJI3VmYkn8aKKykM2j1NUdSgintGWWJJF9HUGiilETPmHxdFHBr1ykMaRqAflQYHX2rl4+Sc0UVoB"    
        }
}
```

### Response Fields

| Field                              | Type   | Description                                         |
| ---------------------------------- | ------ | --------------------------------------------------- |
| entity                             | object | Contains the NIN holder's identity and slip 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.email                       | string | Email address 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.nin\_id                     | string | Base64-encoded NIN slip document (PDF)              |

### Test Credentials for Sandbox

Kindly use this Test NIN in sandbox Environment

nin = `70123456789`