PAN Fetch-V2
Introduction
Our PAN Fetch API is designed to provide a wide array of valuable details based on a PAN number. By simply inputting a PAN number, this API returns a wealth of pertinent information. The response includes the full name of the holder, PAN status (Valid or Not), Aadhar seeding status (linked or unlinked), the type of holder, and also tax compliance status if requested.
Use Cases
The Signzy PAN fetch API can be used by a variety of clients who need to verify PAN numbers for compliance, risk management, or identity verification purposes. Some of the most common use cases are:
Financial Institutions
Financial institutions such as banks, insurance companies, and investment firms are required to comply with KYC regulations and verify the identity of their customers. The Signzy PAN fetch API can help these institutions to quickly and accurately verify the PAN numbers of their customers, reducing the risk of fraud and ensuring regulatory compliance.
Fintech Companies
Fintech companies that offer digital financial services such as mobile wallets, peer-to-peer lending, and investment platforms need to verify the PAN numbers of their users to prevent fraud, money laundering, and other illegal activities. The Signzy PAN fetch API can provide these companies with a fast and reliable way to verify the identity of their users and ensure compliance with regulatory requirements.
HR and Recruitment Agencies
HR departments and recruitment agencies need to verify the PAN numbers of job applicants to ensure that they have provided accurate information on their resumes. The Signzy PAN fetch API can help these organizations to quickly and accurately verify the PAN numbers of job applicants, reducing the risk of hiring unqualified or fraudulent candidates.
Government Agencies
Government agencies need to verify the PAN numbers of individuals for various purposes such as tax compliance, social welfare programs, and public health initiatives. The Signzy PAN fetch API can help these agencies to quickly and accurately verify the identity of individuals and ensure compliance with regulatory requirements.
E-commerce and Online Marketplaces
E-commerce platforms and online marketplaces need to verify the PAN numbers of their sellers to ensure that they are legitimate and trustworthy. The Signzy PAN fetch API can help these platforms to quickly and accurately verify the identity of their sellers, reducing the risk of fraud and ensuring a safe and secure online marketplace.
API details
Endpoint
POST https://signzy.tech/api/v2/patrons/<your patron ID>/panv2POST https://preproduction.signzy.tech/api/v2/patrons/<your patron ID>/panv2Request 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 |
|---|---|---|---|
task | String | Specifies the type of task to be performed.It should be “fetch" for this task. | Mandatory |
essentials | Object | Contains the essential parameters for the task. | Mandatory |
essentials.number | String | The PAN (Permanent Account Number) to fetch information for. | Mandatory |
essentials.returnIndividualTaxComplianceInfo | String | true if you want the individual tax compliance should be checked else false. | Optional |
{
"task": "fetch",
"essentials": {
"number": "XXXXX0000X",
"returnIndividualTaxComplianceInfo": "true"
}
}Response body parameters
Parameter | Data Type | Description |
|---|---|---|
essentials | Object | Contains the essential parameters for the request. |
essentials.number | String | The PAN number from the input. |
essentials.returnIndividualTaxComplianceInfo | Boolean | Indicates if individual tax compliance information should be returned. This is given in the request. |
id | String | Unique ID for the task performed. |
patronId | String | Your Patron ID is returned here. |
task | String | task in the input is returned here. |
result | Object | Contains the result of the task. |
result.name | String | The full name. |
result.number | String | The PAN number. |
result.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. |
result.isIndividual | Boolean | Indicates if the PAN number holder is an individual. true if the PAN holder is an individual else false. |
result.isValid | Boolean | Indicates if the PAN number is Valid. true if the PAN number is valid else false. |
result.firstName | String | The first name of the PAN card holder. |
result.middleName | String | The middle name of the PAN card holder. |
result.lastName | String | The last name of the PAN card holder. |
result.title | String | The title associated with the PAN card holder. (This might be empty in response for some cases) |
result.panStatus | String | The status of the PAN.(Refer to PAN status codes below for possible values). |
result.panStatusCode | String | A code representing the PAN status. (Refer to PAN status codes below for possible values). |
result.aadhaarSeedingStatus | String | The status of Aadhaar seeding .(Refer to Aadhaar Seeding Status Codes below for possible values). |
result.aadhaarSeedingStatusCode | String | A code representing the Aadhar seeding status.(Refer to Aadhaar Seeding Status Codes below for possible values). |
result.lastUpdatedOn | String | The date when the information on PAN was last updated. In format DD/MM/YYYY. |
result.updatetTimestamp | Integer | Timestamp value in seconds using the UNIX(or POSIX) format and the IST time zone. |
result.individualTaxComplianceStatus | String | The status of individual tax compliance. "operative" if individualTaxComplianceStatus is "Y" else "inoperative". This is provided only when "returnIndividualTaxComplianceInfo" is "true". |
{
"essentials": {
"number": "XXXXX0000X",
"returnIndividualTaxComplianceInfo": "true"
},
"id": "650a9424ab5b3c002231b1de",
"patronId": "XXXXXXXXXXXXXXXXXX",
"task": "fetch",
"result": {
"name": "JOE SAMPLE",
"number": "XXXXX0000X",
"typeOfHolder": "Individual or Person",
"isIndividual": true,
"isValid": true,
"firstName": "JOE",
"middleName": "",
"lastName": "SAMPLE",
"title": "Kumari",
"panStatus": "VALID",
"panStatusCode": "E",
"aadhaarSeedingStatus": "Successful",
"aadhaarSeedingStatusCode": "Y",
"lastUpdatedOn": "DD/MM/YYYY",
"updatetTimestamp": 1694415775,
"individualTaxComplianceStatus": "operative"
}
}Status codes
PAN Status codes
Status code | Status |
|---|---|
E | VALID |
F | FAKE |
X | DEACTIVATED |
D | DELETED |
N | INVALID |
EA | AMALGAMATION |
EC | ACQUISITION |
ED | DEATH |
EI | DISSOLUTION |
EL | LIQUIDATED |
EM | MERGER |
EP | PARTITION |
ES | SPLIT |
EU | UNDER LIQUIDATION |
I | INOPERATIVE |
Aadhaar Seeding Status codes
Status code | Status | Meaning |
|---|---|---|
Y | Successful | PAN Aadhaar linked |
R | UnSuccessful | PAN Aadhaar not linked |
Blank | Aadhaar is not seeded | Invalid PAN, hence Aadhaar not seeded |
NA | Not applicable | PAN is non-individual. Hence seeding not applicable. |
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!