> For the complete documentation index, see [llms.txt](https://docs.udara360.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.udara360.io/udara360-docs-1/operations/validate-tin.md).

# Validate TIN

To validate a TIN, make a <mark style="color:yellow;">`POST`</mark> request to this endpoint, passing the `tin` in the request body.

A successful request returns a `verification` object confirming the match status, along with a `result` object containing the taxpayer's business details; `name`, `CAC registration number`, `tax office`, and `contact information`.

This process allows you to confirm a TIN is genuine and belongs to the business providing it, before onboarding them or processing a related transaction.

<mark style="color:yellow;">`POST`</mark> `/api/Operations/v1/KYC/ValidateTIN`

**Headers**

| Name                                                | Value                | Description                                 |
| --------------------------------------------------- | -------------------- | ------------------------------------------- |
| Content-Type<mark style="color:red;">\*</mark>      | `application/json`   | Format of the request payload               |
| Authorization<mark style="color:red;">\*</mark>     | `bearer {token}`     | Access token obtained from Get Access Token |
| request-reference<mark style="color:red;">\*</mark> | `{unique_reference}` | A unique reference identifying this request |

**Body Parameters**

<table><thead><tr><th>Name</th><th>Data Type (Length)</th><th data-type="checkbox">Required</th><th>Description</th></tr></thead><tbody><tr><td>tin</td><td>string (11)</td><td>true</td><td>The Tax Identification Number to validate</td></tr></tbody></table>

**Body table**

| Field            | Data Type | Description                                            |
| ---------------- | --------- | ------------------------------------------------------ |
| `status`         | string    | Whether the TIN verification succeeded                 |
| `reference`      | string    | Reference ID for this verification request             |
| `taxpayer_name`  | string    | Registered name of the taxpayer/business               |
| `cac_reg_number` | string    | CAC (Corporate Affairs Commission) registration number |
| `firstin`        | string    | First Tax Identification Number issued (legacy TIN)    |
| `jittin`         | string    | TIN issued via the Joint Tax Board's JITAS platform    |
| `tax_office`     | string    | Tax office where the TIN is registered                 |
| `phone_number`   | string    | Registered phone number                                |
| `email`          | string    | Registered email address                               |

Here is an example request and response with a sample payload sent to the endpoint in Curl format.

<details>

<summary>Sample Request</summary>

```json
curl --location -g --request POST '{{baseurl}}/api/Operations/v1/KYC/ValidateTIN' \
--header 'Authorization: bearer {token}' \
--header 'request-reference: {unique_reference}' \
--header 'Content-Type: application/json' \
--data ''
```

</details>

<details>

<summary>Response : <code>200</code></summary>

```
{
  "data": {
    "verification": {
      "status": "true",
      "reference": "1223jjjjfj"
    },
    "result": {
      "taxpayer_name": "string",
      "cac_reg_number": "string",
      "firstin": "string",
      "jittin": "string",
      "tax_office": "string",
      "phone_number": "string",
      "email": "string"
    }
  },
  "status": true,
  "message": "Verification Successful"
}
```

</details>