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

# Zimbabwe National ID

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

### Request

```http [GET] theme={null}
{{baseURL}}/api/v1/zw/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 |
| ---------- | ------ | ---------------------- | -------- |
| id\_number | string | Zimbabwian National ID | required |

### Sample response

```json Response theme={null}
{
    "entity": {
        "person_no": "451234561E45",
        "status": "A",
        "surname": "MUSA",
        "first_name": "JOHN",
        "sex": "F",
        "date_of_birth": "1901-01-01",
        "date_of_death": "1961-01-01",
        "birth_place": "Earth"
    }
}
```

### Response Fields

| Field                  | Type   | Description                                       |
| ---------------------- | ------ | ------------------------------------------------- |
| entity                 | object | Contains the verification response data           |
| entity.person\_no      | string | Unique person number from the national registry   |
| entity.status          | string | Status code of the record (e.g., A for active)    |
| entity.surname         | string | Surname of the individual                         |
| entity.first\_name     | string | First name of the individual                      |
| entity.sex             | string | Sex of the individual (M or F)                    |
| entity.date\_of\_birth | string | Date of birth in YYYY-MM-DD format                |
| entity.date\_of\_death | string | Date of death in YYYY-MM-DD format, if applicable |
| entity.birth\_place    | string | Place of birth                                    |