Extraction

8 min

Introduction

The Extraction API is used to extract certain details from the PAN card like name, Father's Name, Date of Birth for Individual PAN cardholders and name, Date of Issue, and so on for Individual PAN holders.

How to call the API

For best results, please make sure that the image you use fits tightly in camera view and is horizontally aligned. Each image/pdf should be less than 2MB.

The PAN Card reading system accepts direct URL to the front side.

API Input Guidelines

Image should be well lit
Image should be less than 2MB in size
API accepts only URLs of image/PDF

Sample Curl

curl --location 'https://api-preproduction.signzy.app/api/v3/pan/extractions' \
--header 'Authorization: <Auth Token>' \
--header 'Content-Type: application/json' \
--data '{
    "files":  [
        "<Url of image>"
        ]
}'

Input Parameters

PARAMETER NAME	DESCRIPTION
Content-Type	application/json
Authorization	Authorization token
files	URL of the image

Sample Response

{
    "files": [
        "<Url of iamge"
    ],
    "id": 93,
    "result": {
        "dob": "01/01/1996",
        "name": " ",
        "fatherName": "BADAN SINGH",
        "number": " ",
        "panType": "Adult",
        "summary": {
            "number": " ",
            "name": "POOJA",
            "dob": " ",
            "address": "",
            "splitAddress": {
                "district": [],
                "state": [
                    []
                ],
                "city": [],
                "pincode": "",
                "country": [],
                "addressLine": ""
            },
            "gender": "",
            "guardianName": "BADAN SINGH",
            "issueDate": "",
            "expiryDate": ""
        }
    }
}

Output Parameters

PARAMETER NAME	DESCRIPTION
files	Contains the image URL of the output.
id	Unique id of the identity
result	This holds final result parameters of the response.
result.name	Name of the PAN cardholder/Organisation name i
result.fatherName	Father's name on the card (valid only for individual PAN)
result.dob	Date Of Birth of cardholder/Date of Issue
result.number	PAN number of the individual
result.panType	Adult or Minor
result.summary.number	PAN number
result.summary.name	Name of the PAN card holder
result.summary.dob	Date of birth of the card holder
result.summary.address	Address of the card holder
result.summary.splitAddress	Address in split form
result.summary.gender	Gender of the card holder
result.summary.guardianName	Name of the guardian
result.summary.issueDate	Date in which the PAN card was issued
result.summary.expiryDate	Expiry date of the card

Status Codes

CODE	MESSAGE
400	Invalid Data
400	Only image(s)/pdf(s) are allowed, one of the urls does not respond like an image
413	Requested entity too large.Please refer docs

Getting help

Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.

You can reach out to us at [email protected].