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

> Verify a Kenyan KRA PIN (Tax PIN) and confirm it is valid and active with the Kenya Revenue Authority.

### Request

```http [GET] theme={null}
{{baseUrl}}/api/v1/ke/kyc/kra?pin=A000000010

```

### 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 |
| --------- | ------ | -------------- | -------- |
| pin \*    | string | The PIN number | required |

### Sample response

```json Response theme={null}
{
  "entity": {
    "current_status": "Registered",
    "effective_from_date": "23/03/2006",
    "effective_to_date": "",
    "obligation_name": "Income Tax - Resident Individual",
    "pin": "A1234567890",
    "pin_status": "Active",
    "taxpayer_name": "JOHN DOE"
  }
}
```

### Response Fields

| Field                        | Type   | Description                                          |
| ---------------------------- | ------ | ---------------------------------------------------- |
| entity                       | object | Contains the verification response data              |
| entity.current\_status       | string | Current registration status of the KRA PIN           |
| entity.effective\_from\_date | string | Date the KRA PIN became effective (dd/MM/yyyy)       |
| entity.effective\_to\_date   | string | Date the KRA PIN expires, if applicable (dd/MM/yyyy) |
| entity.obligation\_name      | string | Tax obligation type associated with the PIN          |
| entity.pin                   | string | KRA PIN number                                       |
| entity.pin\_status           | string | Active or inactive status of the PIN                 |
| entity.taxpayer\_name        | string | Name of the taxpayer                                 |