PAN Simple

Introduction

The PAN Simple API provides an efficient solution for quickly accessing essential details linked to a PAN (Permanent Account Number). By simply inputting a PAN number, users can retrieve comprehensive information including the full name, date of birth, and PAN status. Ideal for businesses and individuals needing fast access to PAN-related data, this API streamlines the process of identity verification and data validation with utmost ease and accuracy.

API details

Endpoint

POST https://api.signzy.app/api/v3/pan/simple

POST https://api-preproduction.signzy.app/api/v3/pan/simple

Request headers

Name	Value	Required	Description
Content-Type	application/json	Mandatory	The type of content that the request body contains.
Authorization	XXXXXXXXXXXXXXX	Mandatory	An authentication token to authorize the request. Reach out to the Signzy support team to get one created.

Request body parameters

Parameter	Data Type	Description	Required
panNumber	String	The PAN (Permanent Account Number) of the individual to retrieve information for.	Mandatory

{
    "panNumber": "XXXXX0000X"
}

Code samples

curl --location 'https://api-preproduction.signzy.app/api/v3/pan/simple' \
--header 'Content-Type: application/json' \
--header 'Authorization: <your-access-token>' \
--data '{
    "panNumber": "XXXXX0000X"
}'

Response body parameters

Parameter	Data Type	Description
result	Object	Contains the result of the task.
result.name	String	The name on the PAN card.
result.firstName	String	The first name of the PAN card holder. (Will be blank for non-Individual PANs)
result.middleName	String	The middle name of the PAN card holder. (Will be blank for non-Individual PANs)
result.lastName	String	The last name of the PAN card holder. (Will be blank for non-Individual PANs)
result.dob	String	The date of birth of the PAN card holder in format YYYY-MM-DD. If the DoB/DoI is invalid in the source, it'll be blank.
result.panStatus	String	The PAN card status. The possible values are: VALID FAKE DEACTIVATED DELETED INVALID AMALGAMATION ACQUISITION DEATH DISSOLUTION LIQUIDATED MERGER PARTITION SPLIT UNDER LIQUIDATION INOPERATIVE If panStatus is not VALID, You will not be able to retrieve the name and DOB. The name and DOB will be empty.

// When pan number is passed as empty string.
{
    "error": {
        "statusCode": 400,
        "status": "Bad Request",
        "message": "panNumber is not allowed to be an empty string",
        "id": "2b9a4056-1479-4337-bb1b-7eab35611dc7"
    }
}
// When invalid pan number is passed.
{
    "error": {
        "statusCode": 400,
        "status": "Bad Request",
        "message": "Invalid panNumber",
        "id": "7ef619cd-349c-4be9-915f-c511ad82ff62"
    }
}

Contact Us for Any Assistance

If you have any questions or need assistance, please reach out to our customer support team. You can contact us via email at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.

We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!