Fetch
Introduction
This service is used to fetch PAN details like PAN holder name, PAN number, Type of holder, whether PAN is valid or not, Whether it is linked to aadhaar or not etc. of an Individual/ Firm/ Company/ HUF / BOI or any type of person as per Income tax act 1961.
Definition of Persons under Income Tax Act, 1961
In terms of section 2 (31) of the Income-tax Act a person includes:
- Individuals
- Partnership Firms
- HUF
- Company
- An individual organization or body of persons whether incorporated or not.
- Local authorities
- Any other legal person who is not subject to any of the above clauses
How to call the API
You must first login before sending the request. The authorization header in the request must include the access token obtained from the login API call.
API Input Guidelines
Need to pass following information
- PAN Number of Person in upper/lower case
Sample Curl
curl --location 'https://api-preproduction.signzy.app/api/v3/panv2-fetch/no-cache' \
--header 'Authorization: <Auth Token>' \
--header 'Content-Type: application/json' \
--data '{
"number": "<Pan NUmber>"
}'Input Parameters
PARAMETER NAME | DESCRIPTION |
|---|---|
Authorization | Contains the id parameter returned from the login step |
Content-Type | application/json |
number | PAN number of any Person for which details to be fetched |
Sample Response
{
"result": {
"name": "<Name of the Person>",
"number": "<PAN Number of the Person>",
"typeOfHolder": "<Type of Holder>",
"isIndividual": <true/false>,
"isValid": <true/false>,
"firstName": "",
"middleName": "",
"lastName": "",
"title": "<Shri/Smt/M/s>",
"panStatus": "<PAN Status>",
"panStatusCode": "E",
"aadhaarSeedingStatus": "Not applicable",
"aadhaarSeedingStatusCode": "NA",
"lastUpdatedOn": "<Last date of Updation>"
},
"vendorData": [
{
"vendorName": "cache",
"vendorService": "elastic",
"statusCode": 200
}
]
}
Response Parameter
PARAMETER NAME | DESCRIPTION |
|---|---|
result | This holds the final result parameters of the response. |
result.name | The name of the person is displayed |
result.number | The pan number is displayed in this parameter. |
result.typeOfHolder | The type of holder for eg., company or individual is displayed |
result.isIndividual | Shows whether the type of holder is an individual or company |
result.isValid | Whether PAN is valid or not true/false |
result.firstName | First name of PAN holder |
result.middleName | Middle name of PAN holder |
result.lastName | Last name of PAN holder in case of individuals, and in case of other than individuals, Person name Middle name of PAN holder |
result.title | Title like for individual Shri/Smt and for others M/s |
result.panStatus | Whether PAN is valid or not |
result.panStatusCode | PAN status code |
result.aadhaarSeedingStatus | Whether PAN is linked to aadhaar or not, in case of PAN linked to aadhaar response shows as Successful, in case of not linked Unsuccessful, and NA(Not Applicable) in case if linking PAN to aadhaar is not applicable |
result.aadhaarSeedingStatusCode | Aadhaar seeding code eg: if successful code will be Y, if Not Applicable code NA. |
result.lastUpdatedOn | Date on which PAN database last updated on |
vendorData | List display the details of vendors that gave the response |
vendorData.vendorName | Name of vendor |
vendorData.vendorService | Service by vendor |
vendorData.statusCode | Status code of the response by vendor |
Pan Card Status
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
Status Code | Status |
|---|---|
Y | Successful |
R | UnSuccessful |
Blank | Aadhaar is not seeded |
NA | Not applicable |
Type of Holder
STATUS CODE | STATUS |
|---|---|
A | Association of persons (AOP) |
B | Body of individuals (BOI) |
C | Company |
F | Firm |
G | Government |
H | HUF (Hindu undivided family) |
L | Local authority |
J | Artificial juridical person |
P | Individual or Person |
T | Trust |
Status Codes
CODE | MESSAGE |
|---|---|
404 | PAN Number not found |
400 | PAN number is not valid |
409 | Error in getting Data from Upstream |
Getting help
Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.
You can reach out to us at [email protected].