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

> Verify a Ghanaian individual Tax Identification Number (TIN) with the revenue authority. For business TIN use Ghana Business Lookup.

### Request

```http [GET] theme={null}
{{baseUrl}}/api/v1/gh/kyb/tin?tin=C00000000021
```

### 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 |
| --------- | ------ | -------------- | -------- |
| tin \*    | string | The TIN number | required |

### Sample response

```json Response theme={null}
{
  "entity": {
    "is_valid": true,
    "regn_status": "REGISTERED",
    "rgdno": "12345678",
    "tax_office": "ACCRA",
    "taxpayer_name": "JOHN DOE",
    "tin": "C1234556787",
    "trading_as": "123R43A"
  }
}
```

### Response Fields

| Field                 | Type    | Description                                 |
| --------------------- | ------- | ------------------------------------------- |
| entity                | object  | Contains the verification response data     |
| entity.is\_valid      | boolean | Whether the TIN is valid                    |
| entity.regn\_status   | string  | Registration status of the taxpayer         |
| entity.rgdno          | string  | Registered number associated with the TIN   |
| entity.tax\_office    | string  | Tax office where the taxpayer is registered |
| entity.taxpayer\_name | string  | Name of the taxpayer                        |
| entity.tin            | string  | Tax Identification Number                   |
| entity.trading\_as    | string  | Trading name or alias of the taxpayer       |