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

# Validate FIRS TIN

> Validate a business's Tax Identification Number with the FIRS

### Request

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

### 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 | A valid TIN | required |

### Sample response

```json Response theme={null}
{
  "entity": {
    "search": "18609323-0001",
    "taxpayer_name": "BRYAN GODWIN NIG LTD",
    "cac_reg_number": "3897612",
    "firstin": "18609323-0001",
    "jittin": "N/A",
    "tax_office": "MSTO ALIMOSHO",
    "phone_number": "08012345678",
    "email": "test@gmail.com"
  }
}
```

### Response Fields

| Field                   | Type   | Description                                          |
| ----------------------- | ------ | ---------------------------------------------------- |
| entity                  | object | Contains the FIRS TIN validation response data       |
| entity.search           | string | The TIN value that was searched                      |
| entity.taxpayer\_name   | string | Registered name of the taxpayer                      |
| entity.cac\_reg\_number | string | CAC registration number associated with the taxpayer |
| entity.firstin          | string | Federal Inland Revenue Service TIN                   |
| entity.jittin           | string | Joint Tax Board TIN (N/A if not available)           |
| entity.tax\_office      | string | Assigned FIRS tax office for the taxpayer            |
| entity.phone\_number    | string | Phone number on file for the taxpayer                |
| entity.email            | string | Email address on file for the taxpayer               |

### Test Credentials for Sandbox

Kindly use this test TIN in the sandbox environment.

TIN = `18609323-0001`