Fetch

12 min

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].