# Pan Card Comprehensive

**Submit Document**

## ind\_pan\_comprehensive

<mark style="color:green;">`POST`</mark> `https://secctrl.tutelar.io/api/v1/kyc/identity/ind_pan_comprehensive`

## Post Parameters description is given below

<table><thead><tr><th width="168">Post Parameter </th><th width="132">Type</th><th>Is  Mandatory</th><th>Description</th></tr></thead><tbody><tr><td>pan_number</td><td>String</td><td>yes</td><td>Pan Card Number</td></tr></tbody></table>

#### Sample Post Parameters

```json
{
    "pan_number": "CNPPG0000D"
}
```

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

```json
{
    "success": true,
    "code": 200,
    "message": "The request has been successfully completed.",
    "reference_id": "fca2faf4-1026-4430-9a61-d40657970083",
    "status": "completed",
    "result": {
        "document_number": "CNPPG0000D",
        "name_on_document": "RAMESH GOWTHAM",
        "first_name": "RAMESH",
        "middle_name": "",
        "last_name": "GOWTHAM",
        "mobile_number": "6382526000",
        "date_of_birth": "1999-07-10",
        "gender": "M",
        "address": {
            "line_1": "",
            "line_2": "Kandhasamy street",
            "street_name": "Timiri S.O",
            "zip": "632512",
            "city": "Timiri",
            "state": "TAMIL NADU",
            "country": "INDIA",
            "full": "Kandhasamy street Timiri S.O 632512 Timiri TAMIL NADU INDIA"
        },
        "aadhaar_seeding_status": true,
        "masked_aadhaar": "XXXXXXXX0870"
    },
    "requested_at": "2024-04-18T09:57:18.907Z",
    "completed_at": "2024-04-18T09:57:20.523Z"
}
```

{% endtab %}

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

```json
{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "9b2601bd-1f4e-4b55-bdac-4783d43c0d5e",
    "status": "in_progress",
    "requested_at": "2024-04-18T13:11:12.428Z"
}
```

{% endtab %}

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

```json
{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "Invalid PAN Number",
        "field": "pan_number",
        "code": "BAD_REQUEST"
    }
}
```

{% endtab %}

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

```json
{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "d9a02bb2-1357-49bd-a1ab-94d06f7f419c",
    "status": "failed",
    "error": {
        "message": "Invalid details were provided. Please submit valid details.",
        "code": "ERROR"
    },
    "requested_at": "2024-04-18T13:14:13.968Z",
    "completed_at": "2024-04-18T13:14:15.000Z"
}
```

{% endtab %}
{% endtabs %}

#### Get Pan Detail

## Get Pan Detail

<mark style="color:blue;">`GET`</mark> `https://secctrl.tutelar.io/api/v1/kyc/identity/ind_pan_comprehensive`

## Query Parameters description is given below

<table><thead><tr><th width="174">query Parameter</th><th width="155">Type</th><th>Is  Mandatory</th><th>Description</th></tr></thead><tbody><tr><td>reference_id</td><td>String</td><td>Yes</td><td>reference id </td></tr></tbody></table>

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

```json
{
    "success": true,
    "code": 200,
    "message": "Document verification completed successfully.",
    "status": "completed",
    "reference_id": "07bf7cd6-b03a-4f9d-a0b2-9e5154ee675b",
    "result": {
        "document_status": "SUCCESS",
        "document_number": "CNPPG4873D",
        "name_on_document": "RAMESH GOWTHAM",
        "first_name": "RAMESH",
        "middle_name": "",
        "last_name": "GOWTHAM",
        "mobile_number": "6382526132",
        "date_of_birth": "1999-07-10",
        "gender": "M",
        "address": {
            "line_1": "45",
            "line_2": "Kandhasamy mudhaliyar street",
            "street_name": "Timiri S.O",
            "zip": "632512",
            "city": "Timiri",
            "state": "TAMIL NADU",
            "country": "INDIA",
            "full": "45 Kandhasamy mudhaliyar street Timiri S.O 632512 Timiri TAMIL NADU INDIA"
        },
        "source": null,
        "aadhaar_seeding_status": true,
        "masked_aadhaar": "XXXXXXXX0870"
    },
    "requested_at": "2023-12-19T10:49:26.781Z",
    "completed_at": "2023-12-19T10:49:27.822Z"
}
```

{% endtab %}

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

```json
{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "9b2601bd-1f4e-4b55-bdac-4783d43c0d5e",
    "status": "in_progress",
    "requested_at": "2024-04-18T13:11:12.428Z"
}
```

{% endtab %}

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

```json
{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "d9a02bb2-1357-49bd-a1ab-94d06f7f419c",
    "status": "failed",
    "error": {
        "message": "Invalid details were provided. Please submit valid details.",
        "code": "ERROR"
    },
    "requested_at": "2024-04-18T13:14:13.968Z",
    "completed_at": "2024-04-18T13:14:15.000Z"
}
```

{% endtab %}
{% endtabs %}