> For the complete documentation index, see [llms.txt](https://docs.tutelar.io/tutelar-api-document/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tutelar.io/tutelar-api-document/kyc-verification/document-extraction/india/pan-card-ocr.md).

# Pan Card OCR

Extracting information in real time from a PAN card image of a person or business.

#### Submit Document

##  ind\_pan\_ocr

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

### Post parameters description is given below,

<table><thead><tr><th width="197">Post Parameter </th><th width="139">Type</th><th>Is  Mandatory</th><th>Description</th></tr></thead><tbody><tr><td>front_side </td><td>String </td><td>Yes </td><td>Image Url</td></tr><tr><td>back_side</td><td>String</td><td>No</td><td>Image Url</td></tr></tbody></table>

#### Sample Post Parameters

```json
{
    "front_side": "Base64 or Url",
    "back_side": "Base64 or Url"
}
```

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

```json
{
    "success": true,
    "code": 200,
    "message": "The request has been successfully completed.",
    "reference_id": "20ac0e3c-25cc-499d-8e6d-a63c81a52547",
    "status": "completed",
    "result": {
        "document_number": "BFAPL0062A",
        "name_on_document": "Selhuvo Lohe",
        "fathers_name": "Chineyi Lohe",
        "date_of_birth": "2001-09-10"
    },
    "requested_at": "2024-04-22T06:54:23.464Z",
    "completed_at": "2024-04-22T06:54:25.632Z"
}
```

{% endtab %}

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

```json
{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "2fd4c21f-478d-4e52-bdc1-87ac29cdb300",
    "status": "in_progress",
    "requested_at": "2024-04-22T06:15:03.375Z"
}
```

{% endtab %}

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

```json
{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "Upload the front image of Aadhar card",
        "field": "front_side",
        "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": "d8f8ec55-35c0-4d8c-86d1-3156c9587855",
    "status": "failed",
    "error": {
        "message": "PAN Not Found.",
        "code": "ERROR"
    },
    "requested_at": "2024-04-22T06:24:49.300Z",
    "completed_at": "2024-04-22T06:24:50.164Z"
}
```

{% endtab %}
{% endtabs %}

#### Check Document Status

## Get document details

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

### 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": "20ac0e3c-25cc-499d-8e6d-a63c81a52547",
    "status": "completed",
    "result": {
        "document_number": "BFAPL0062A",
        "name_on_document": "Selhuvo Lohe",
        "fathers_name": "Chineyi Lohe",
        "date_of_birth": "2001-09-10"
    },
    "requested_at": "2024-04-22T06:54:23.464Z",
    "completed_at": "2024-04-22T06:54:25.632Z"
}
```

{% endtab %}

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

````json
{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "2fd4c21f-478d-4e52-bdc1-87ac29cdb300",
    "status": "in_progress",
    "requested_at": "2024-04-22T06:15:03.375Z"
}```postman_json
{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "d8f8ec55-35c0-4d8c-86d1-3156c9587855",
    "status": "failed",
    "error": {
        "message": "PAN Not Found.",
        "code": "ERROR"
    },
    "requested_at": "2024-04-22T06:24:49.300Z",
    "completed_at": "2024-04-22T06:24:50.164Z"
}
```
````

{% endtab %}

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

```json
{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "d8f8ec55-35c0-4d8c-86d1-3156c9587855",
    "status": "failed",
    "error": {
        "message": "PAN Not Found.",
        "code": "ERROR"
    },
    "requested_at": "2024-04-22T06:24:49.300Z",
    "completed_at": "2024-04-22T06:24:50.164Z"
}
```

{% endtab %}
{% endtabs %}