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/premiumhttps://api-preproduction.signzy.app/api/v3/pan-extensive/premiumRequest 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!