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

> Verify a Ugandan National ID and fetch holder details from the national registry using the NIN.

### Request

```http [GET] theme={null}
{{baseUrl}}/api/v1/ug/kyc/nin
```

### Header

| Header        | Type   | Description                                                                                         |
| ------------- | ------ | --------------------------------------------------------------------------------------------------- |
| AppId         | string | Create an app to get your app ID on dashboard [here](https://app.dojah.io/developers/configuration) |
| Authorization | string | Private/secret key. Use `<key>` not `Bearer <key>`                                                  |

### Query parameter

| Parameter   | Type   | Description                           | Required |
| ----------- | ------ | ------------------------------------- | -------- |
| nin \*      | string | National ID Number (NIN)              | required |
| first\_name | string | The first name of the document holder | optional |
| last\_name  | string | The last name of the document holder  | optional |

### Sample response

```json Response theme={null}
{
  
    "entity": {
        "id_number": "CM123456789AB",
        "first_name": "John",
        "last_name": "Musa",
        "middle_name": "Doe",
        "date_of_birth": "1990-01-01"
    }

  
}
```

### Response Fields

| Field                  | Type   | Description                                |
| ---------------------- | ------ | ------------------------------------------ |
| entity                 | object | Contains the verification response data    |
| entity.id\_number      | string | National ID Number (NIN) of the individual |
| entity.first\_name     | string | First name of the individual               |
| entity.last\_name      | string | Last name of the individual                |
| entity.middle\_name    | string | Middle name of the individual              |
| entity.date\_of\_birth | string | Date of birth in YYYY-MM-DD format         |