# TAN Verification

The TAN Number Validation API instantly verifies TAN numbers and provides associated company details, ensuring accurate compliance and efficient tax-related validation. 

## TAN Verification

<mark style="color:green;">`POST`</mark> `https://secctrl.tutelar.io/api/v1/services/business_profile/tan_verification`

#### Sample Request Body

<table><thead><tr><th width="167">Body</th><th width="148">Type</th><th>Mandatory</th><th>Description</th></tr></thead><tbody><tr><td>tan_number</td><td>string</td><td>Yes</td><td>TAN number to be validate.</td></tr></tbody></table>

#### Sample Post Parameters

```json
{
    "tan_number": "ABCD12345A",
}
```

{% tabs %}
{% tab title="200: Success Response" %}

```json
{
    "success": true,
    "code": 200,
    "message": "The request has been successfully completed.",
    "reference_id": "1ee90281-daea-40e6-9125-8e859b432948",
    "status": "completed",
    "result": {
        "is_valid": true,
        "company_name": "NIPPON INDIA MUTUAL FUND"
    },
    "requested_at": "2026-02-25T11:03:22.711Z",
    "completed_at": "2026-02-25T11:03:24.119Z"
}
```

{% endtab %}

{% tab title="400: Validation Error Response" %}

```json
{
    "success": false,
    "code": 400,
    "message": "TAN Number should not be empty",
    "error": {
        "message": "TAN Number should not be empty",
        "field": "tan_number",
        "code": "BAD_REQUEST"
    }
}

{
    "success": false,
    "code": 400,
    "message": "TAN Number is invalid",
    "error": {
        "message": "TAN Number is invalid",
        "field": "tan_number",
        "code": "BAD_REQUEST"
    }
}
```

{% endtab %}

{% tab title="200 : In progress" %}

```json
{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "91084d90-4468-43c8-b537-cd7a69d2e2b1",
    "status": "in_progress",
    "requested_at": "2026-02-25T14:40:18.115Z"
}
```

{% endtab %}

{% tab title="200: Failure Response" %}

```json
{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "310f8e78-4d6c-405a-bc9f-8760d84c7d0e",
    "status": "failed",
    "error": {
        "message": "companyName is not found",
        "code": "ERROR"
    },
    "requested_at": "2026-02-25T11:02:17.404Z",
    "completed_at": "2026-02-25T11:02:18.263Z"
}
```

{% endtab %}
{% endtabs %}

#### Check Document Status

## Get document details

<mark style="color:blue;">`GET`</mark> `https://secctrl.tutelar.io/api/v1/services/business_profile/tan_verification`

### Query parameters description is given below,

<table><thead><tr><th width="197">Query Parameter </th><th width="139">Type</th><th>Is  Mandatory</th><th>Description</th></tr></thead><tbody><tr><td>reference_id </td><td>String </td><td>Yes </td><td>Document reference id</td></tr></tbody></table>

{% tabs %}
{% tab title="200: Success Response" %}

```json
{
    "success": true,
    "code": 200,
    "message": "The request has been successfully completed.",
    "reference_id": "1ee90281-daea-40e6-9125-8e859b432948",
    "status": "completed",
    "result": {
        "is_valid": true,
        "company_name": "NIPPON INDIA MUTUAL FUND"
    },
    "requested_at": "2026-02-25T11:03:22.711Z",
    "completed_at": "2026-02-25T11:03:24.119Z"
}
```

{% endtab %}

{% tab title="200: Inprogress Response" %}

```json
{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "91084d90-4468-43c8-b537-cd7a69d2e2b1",
    "status": "in_progress",
    "requested_at": "2026-02-25T14:40:18.115Z"
}
```

{% endtab %}

{% tab title="200: Failure Response" %}

```json
{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "310f8e78-4d6c-405a-bc9f-8760d84c7d0e",
    "status": "failed",
    "error": {
        "message": "companyName is not found",
        "code": "ERROR"
    },
    "requested_at": "2026-02-25T11:02:17.404Z",
    "completed_at": "2026-02-25T11:02:18.263Z"
}
```

{% endtab %}
{% endtabs %}