> ## 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 Kenya National ID

> Verify a Kenyan National ID and fetch holder details from the national registry using the ID number.

### Request

```test [GET] theme={null}
{{baseURL}}/api/v1/ke/kyc/id
```

### 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 |
| --------- | ------ | ---------------------- | -------- |
| id \*     | string | The national ID number | required |

### Sample response

```json Response theme={null}
{
  "entity": {
    "date_of_birth": "1996-02-21",
    "first_name": "John",
    "gender": "M",
    "id": "123456789",
    "is_date_of_birth_match": true,
    "is_first_name_match": true,
    "is_gender_match": true,
    "is_last_name_match": true,
    "is_middle_name_match": true,
    "last_name": "Musa",
    "middle_name": "Doe"
  }
}
```

### Response Fields

| Field                             | Type    | Description                                           |
| --------------------------------- | ------- | ----------------------------------------------------- |
| entity                            | object  | Contains the verification response data               |
| entity.date\_of\_birth            | string  | Date of birth of the individual (yyyy-MM-dd)          |
| entity.first\_name                | string  | First name of the individual                          |
| entity.gender                     | string  | Gender of the individual                              |
| entity.id                         | string  | National ID number                                    |
| entity.is\_date\_of\_birth\_match | boolean | Whether the provided date of birth matches the record |
| entity.is\_first\_name\_match     | boolean | Whether the provided first name matches the record    |
| entity.is\_gender\_match          | boolean | Whether the provided gender matches the record        |
| entity.is\_last\_name\_match      | boolean | Whether the provided last name matches the record     |
| entity.is\_middle\_name\_match    | boolean | Whether the provided middle name matches the record   |
| entity.last\_name                 | string  | Last name of the individual                           |
| entity.middle\_name               | string  | Middle name of the individual                         |