PAN Fetch V3
Introduction
Our PAN Fetch API is designed to provide a wide array of valuable details based on a PAN number. By simply requesting using 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), Aadhaar 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 quickly and accurately verify the PAN numbers of their customers, reducing the risk of fraud and ensuring regulatory compliance.
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 during their onboarding. The Signzy PAN fetch API can help these organizations 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 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 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://api.signzy.app/api/v3/pan/fetchV2POST https://api-preproduction.signzy.app/api/v3/pan/fetchV2Request body parameters
Parameter | Data Type | Description | Required |
|---|---|---|---|
number | String | The PAN (Permanent Account Number) to fetch information for. | Mandatory |
returnIndividualTaxComplianceInfo | String | true if you want the individual tax compliance should be checked otherwise, false. | Optional |
consent | String | User's consent | Optional |
{
"number": "XXXXX0000X",
"returnIndividualTaxComplianceInfo": "true",
"consent":"Y/N"
}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. |
Code Samples
curl --location 'https://api-preproduction.signzy.app/api/v3/pan/fetchV2' \
--header 'Authorization: <Token>' \
--header 'Content-Type: application/json' \
--data '{
"number": "<PAN Number>",
"returnIndividualTaxComplianceInfo": "true",
"consent":"Y/N"
}'Response body parameters
Parameter | Data Type | Description |
|---|---|---|
result | Object | Contains the response for the input PAN number. |
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. (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.title | String | The title associated with the PAN card holder. This can be empty. |
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). This can be empty. |
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. This can be empty. |
result.updatetTimestamp | Integer | Timestamp value in seconds using the UNIX(or POSIX) format and the IST time zone. This can be empty. |
result.individualTaxComplianceStatus | String | The status of individual tax compliance. "operative" if aadhaarSeedingStatusCode is "Y" else "inoperative". This is provided only when "returnIndividualTaxComplianceInfo" is "true". |
{
"error": {
"reason": "Error From Upstream",
"status": 409,
"message": "Upstream Down",
"type": "Conflict",
"statusCode": 409,
"name": "error"
}
}Note:
Fields result.title, result.panStatusCode, result.lastUpdatedOn, result.updatetTimestamp can contain empty data.
Status codes
PAN Status codes
Status code | PAN 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 |
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!