PAN Extensive Premium

Introduction

Introducing the Enhanced PAN Premium API, a powerful and efficient tool designed to retrieve comprehensive information associated with a given Permanent Account Number (PAN) in India.

The response provides essential details such as the individual's full name, gender, date of birth, PAN type, and the newly added father’s name. Additionally, the API offers masked Aadhaar information to ensure data privacy and security.

The PAN Premium API is an invaluable asset for streamlining onboarding processes, conducting thorough verifications, and enhancing customer due diligence, making it an indispensable tool for financial institutions, businesses, and organizations requiring reliable and comprehensive identity verification.

API details

Endpoint

https://api.signzy.app/api/v3/pan-extensive/premium

https://api-preproduction.signzy.app/api/v3/pan-extensive/premium

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) to fetch information for.	Mandatory
getStatusInfo	Boolean	true if you want panStatus, panStatusCode, isValid information else false.	Optional

{
    "panNumber": "XXXXX0000X",
    "getStatusInfo": true // optional
}

Code samples

curl --location 'https://api-preproduction.signzy.app/api/v3/pan-extensive/premium' \
--header 'Content-Type: application/json' \
--header 'Authorization: auth token' \
--data '{
    "panNumber": "ABCDEF1234T",
    "getStatusInfo": false
}'

Response body parameters

Parameter	Data Type	Description
name	String	Full name of the PAN card holder.
number	String	PAN number.
firstName	String	First name of the PAN card holder. (Will be blank for non-Individual PANs)
middleName	String	Middle name of the PAN card holder. (Will be blank for non-Individual PANs)
lastName	String	Last name of the PAN card holder. (Will be blank for non-Individual PANs)
fatherName	String	Father name of the PAN card holder
typeOfHolder	String	The type of holder. The possible values are: Association of persons (AOP), Body of individuals (BOI), Company, Firm, Government, HUF (Hindu undivided family), Local authority, Artificial juridical person, Individual or Person, Trust.
gender	String	Gender of the PAN card holder.
isIndividual	Boolean	Indicates if the holder is an individual. true if the holder of the PAN number is an individual else false.
category	String	The category of the PAN card. The possible values are: company, person, huf, firm, aop, aop_trust, boi, local_authority, artificial_juridical_person, government.
dateOfBirth	String	Date of birth of the PAN card holder in the format DD-MM-YYYY.
maskedAadhaarNumber	String	Masked Aadhaar number in below 2 formats: i) last 4 digits unmasked (XXXXXXXX0000) ii) First and last 2 digits unmasked (00xxxxxxxx00
emailId	String	Email ID linked with the PAN number. [Deprecated]
mobileNumber	String	Mobile number linked with the PAN number. [Deprecated]
aadhaarLinked	Boolean	Indicates if the Aadhar is linked to the given PAN. true if the provided PAN and Aadhaar number are linked else false.
address	Object	Contains the address of the PAN card holder.[Deprecated]
address.fullAddress	String	Full address of the PAN card holder.
address.addressLineOne	String	The first line of the address.
address.addressLineTwo	String	The second line of the address.
address.street	String	The street from the address.
address.city	String	City.
address.state	String	State.
address.pincode	String	PIN code.
address.country	String	Country.
panStatus	String	The status of the PAN.(Refer to PAN status codes below for possible values).
panStatusCode	String	A code representing the PAN status. (Refer to PAN status codes below for possible values). This can be empty.
isValid	boolean	Indicates if the PAN number is Valid. true if the PAN number is valid else false.

// When getStatusInfo is not passed or passed as false.
{
    "name": "FULL NAME",
    "number": "ABCDE1234E",
    "firstName": "FIRST NAME",
    "middleName": "MIDDLE NAME",
    "lastName": "LAST NAME",
    "fatherName" : "FATHER NAME"
    "typeOfHolder": "Individual or Person",
    "gender": "Female",
    "isIndividual": true,
    "category": "person",
    "dateOfBirth": "DD-MM-YYYY",
    "maskedAadhaarNumber": "XXXXXXXX0353/23XXXXXXXX53",
    "emailId": "",
    "mobileNumber": "",
    "aadhaarLinked": true,
    "address": {
        "fullAddress": "",
        "addressLineOne": "",
        "addressLineTwo": "",
        "street": "",
        "city": "",
        "state": "",
        "pincode": "",
        "country": "India"
    }
}

// When getStatusInfo is passed as true.
{
    "name": "FULL NAME",
    "number": "ABCDE1234E",
    "firstName": "FIRST NAME",
    "middleName": "MIDDLE NAME",
    "lastName": "LAST NAME",
    "fatherName": "FATHER NAME"
    "typeOfHolder": "Individual or Person",
    "gender": "Female",
    "isIndividual": true,
    "category": "person",
    "dateOfBirth": "DD-MM-YYYY",
    "maskedAadhaarNumber": "XXXXXXXX0353/23XXXXXXXX53",
    "emailId": "",
    "mobileNumber": "",
    "aadhaarLinked": true,
    "address": {
        "fullAddress": "",
        "addressLineOne": "",
        "addressLineTwo": "",
        "street": "",
        "city": "",
        "state": "",
        "pincode": "",
        "country": "India"
    },
    "isValid": true,
    "panStatus": "VALID",
    "panStatusCode": "E"
}

Status codes

PAN Status codes

Status Code	Description
E	Existing and Valid
F	Marked as Fake
X	Marked as Deactivated
D	Deleted
N	Record (PAN) Not Found in ITD Database/Invalid PAN
EA	Existing and Valid but event marked as Amalgamation
EC	Existing and Valid but event marked as Acquisition
ED	Existing and Valid but event marked as Death
EI	Existing and Valid but event marked as Dissolution
EL	Existing and Valid but event marked as Liquidated
EM	Existing and Valid but event marked as Merger
EP	Existing and Valid but event marked as Partition
ES	Existing and Valid but event marked as Split
EU	Existing and Valid but event marked as Under Liquidation

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!