Data Structure For PAN Inquiry API

Note: The data should be transmitted through HTTPs request using POST method using the following parameters

Sr. No Parameter Data type Parameter description Mandatory / Optional

1 data Char Contains details of User-id and PANs M
Digital signature in PKCS7 format with
2 signature Char base 64 encoding M
Contains Input version as 2 or blank. If
user is sending additional version(2)
parameter in the API request then new
response will be received otherwise old
3 version Char response. M

Structure of 'Data' Parameter

Note: Each field should be separated with "^"

Field Name Mandatory

Sr. No / Optional Size
1 User ID M 12 Max Length : 12 , Min Length : 8
2 PAN1 10
3 PAN2 10
4 PAN3 Atleast one
is M 10
5 PAN4 10
6 PAN5 10
Total size 67
 TAN Extract file format Ver. 1.0

Data Structure For PAN Inquiry API

General Notes for All Record Types
1 Output will be in text string separated with "^" mark in ASCII characters
2 Output for all PAN will be in same sequence, in which they are in input
3 In case 'E' and 'E along with event' output detail will be shown to user
4 In case 'N' ,'F','X','D' or data being not present, number of carats "^" will be same for each PAN
5 Except for Return Code 1, output will be two digit integer only
6 Return Codes : 1,2,3,4,5,6,7,8,9,10,11,12,15,16,17,18,19,20,21
DATA STRING OUTPUT
Data Mandatory
Sr.No Fields
Type
Size
(M/O)
Valid/Default Values

D1 Return code Integer 2 M 1,2,3,4,5,6,7,8,9,10,11,1

D2 PAN1 Char 10 M

D3 PAN-Status1 Char 2 M

D4 Last-Name1 Char 75 O
D5 First-Name1 Char 25 O
D6 Middle-Name1 Char 25 O
D7 PAN-title1 Char 6 O

D8 Date of Birth / Incorporation Date 10 O

Internal Use Page 1

 TAN Extract file format Ver. 1.0

D9 Father's Last name/ Surname Char 25 O

D10 Father's First Name Char 25 O

D11 Father;s Middle Name Char 25 O

D12 Last-update-date1 Date 10 O

D13 Name on card1 Char 85 O

D14 Aadhaar PAN linking Status Char 2 O

D15 Filler 1 Char 25 O

D16 PAN2 Char 10 M

D17 PAN-Status2 Char 2 M

D18 Last-Name2 Char 75 O

Internal Use Page 1

 TAN Extract file format Ver. 1.0

D19 First-Name2 Char 25 O

D20 Middle-Name2 Char 25 O
D21 PAN-title2 Char 6 O

D22 Date of Birth / Incorporation Date 10 O

D23 Father's Last name/ Surname Char 25 O

D24 Father's First Name Char 25 O

D25 Father;s Last Name Char 25 O

D26 Last-update-date2 Date 10 O

D27 Name on card2 Char 85 O

D28 Aadhaar PAN linking Status Char 2 O

D29 Filler 2 Char 25 O

D30 PAN3 Char 10 M

Internal Use Page 1

 TAN Extract file format Ver. 1.0

D31 PAN-Status3 Char 2 M

D32 Last-Name3 Char 75 O

D33 First-Name3 Char 25 O
D34 Middle-Name3 Char 25 O
D35 PAN-title3 Char 6 O

D36 Date of Birth / Incorporation Date 10 O

D37 Father's Last name/ Surname Char 25 O

D38 Father's First Name Char 25 O

D39 Father;s Middle Name Char 25 O

D40 Last-update-date3 Date 10 O

D41 Name on card3 Char 85 O

Internal Use Page 1

 TAN Extract file format Ver. 1.0

D42 Aadhaar PAN linking Status Char 2 O

D43 Filler 3 Char 25 O

D44 PAN4 Char 10 M

D45 PAN-Status4 Char 2 M

D46 Last-Name4 Char 75 O

D47 First-Name4 Char 25 O
D48 Middle-Name4 Char 25 O
D49 PAN-title4 Char 6 O

D50 Date of Birth / Incorporation Date 10 O

D51 Father's Last name/ Surname Char 25 O

D52 Father's First Name Char 25 O

Internal Use Page 1

 TAN Extract file format Ver. 1.0

D53 Father;s Middle Name Char 25 O

D54 Last-update-date4 Date 10 O

D55 Name on card4 Char 85 O

D56 Aadhaar PAN linking Status Char 2 O

D57 Filler 4 Char 25 O

D58 PAN5 Char 10 M

D59 PAN-Status5 Char 2 M

D60 Last-Name5 Char 75 O

D61 First-Name5 Char 25 O
D62 Middle-Name5 Char 25 O
D63 PAN-title5 Char 6 O

D64 Date of Birth / Incorporation Date 10 O

Internal Use Page 1

 TAN Extract file format Ver. 1.0

D65 Father's Last name/ Surname Char 25 O

D66 Father's First Name Char 25 O

D67 Father;s Middle Name Char 25 O

D68 Last-update-date5 Date 10 O

D69 Name on card5 Char 85 O

D70 Aadhaar PAN linking Status Char 2 O

D71 Filler 5 Char 25 O

Internal Use Page 1

 TAN Extract file format Ver. 1.0

Description/Comments

As per the error codes in Error Codes sheet

As provided by user in request

“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” in ITD
database
"EC" - Existing and Valid but event marked as “Acquisition” in ITD
database
"ED" - Existing and Valid but event marked as “Death” in ITD database
"EI" - Existing and Valid but event marked as “Dissolution” in ITD
database
"EL" - Existing and Valid but event marked as “Liquidated” in ITD
database
"EM" - Existing and Valid but event marked as “Merger” in ITD
database
"EP" - Existing and Valid but event marked as “Partition” in ITD
database
"ES" - Existing and Valid but event marked as “Split” in ITD database
"EU" - Existing and Valid but event marked as “Under Liquidation” in
ITD database

[Data to be displayed for status E and E along with event]

[Data to be displayed for status E and E along with event]
[Data to be displayed for status E and E along with event]
[Data to be displayed for status E and E along with event]
1. DOB as present in ITD database will be displayed. 2.
The date will be in DD/MM/YYYY format.
3. Data to be displayed for status E and E along with event

Internal Use Page 1

 TAN Extract file format Ver. 1.0

1. Value as present in ITD database will be displayed. 2.

Value will be displayed only if the category of PAN is 'Individual', If other than
Individual value to be dispalyed as 'Not Applicable(NA)'
3. Data to be displayed for status E and E along with event
1. Value as present in ITD database will be displayed. 2.
Value will be displayed only if the category of PAN is 'Individual', If other than
Individual value to be dispalyed as 'Not Applicable(NA)' 3. Data to
be displayed for status E and E along with event
1. Value as present in ITD database will be displayed. 2.
Value will be displayed only if the category of PAN is 'Individual', If other than
Individual value to be dispalyed as 'Not Applicable(NA)' 3. Data to
be displayed for status E and E along with event
[Data to be displayed for status E and E along with event]
Name on card [Data to be displayed for status E and E along with
event] information will be displayed for status E and E
Below
along with event.

Y – Operative PAN
R - Inoperative PAN
NA - For all non-
Individual PANs
Reserved for future use and will not have any value
As provided by user in request

“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” in ITD
database
"EC" - Existing and Valid but event marked as “Acquisition” in ITD
database
"ED" - Existing and Valid but event marked as “Death” in ITD database
"EI" - Existing and Valid but event marked as “Dissolution” in ITD
database
"EL" - Existing and Valid but event marked as “Liquidated” in ITD
database
"EM" - Existing and Valid but event marked as “Merger” in ITD
database
"EP" - Existing and Valid but event marked as “Partition” in ITD
database
"ES" - Existing and Valid but event marked as “Split” in ITD database
"EU" - Existing and Valid but event marked as “Under Liquidation” in
ITD database

[Data to be displayed for status E and E along with event]

Internal Use Page 1

 TAN Extract file format Ver. 1.0

[Data to be displayed for status E and E along with event]

[Data to be displayed for status E and E along with event]
[Data to be displayed for status E and E along with event]
1. DOB as present in ITD database will be displayed. 2.
The date will be in DD/MM/YYYY format.
3. Data to be displayed for status E and E along with event
1. Value as present in ITD database will be displayed. 2.
Value will be displayed only if the category of PAN is 'Individual', If other than
Individual value to be dispalyed as 'Not Applicable(NA)' 3. Data to
be displayed for status E and E along with event
1. Value as present in ITD database will be displayed. 2.
Value will be displayed only if the category of PAN is 'Individual', If other than
Individual value to be dispalyed as 'Not Applicable(NA)' 3. Data to
be displayed for status E and E along with event
1. Value as present in ITD database will be displayed. 2.
Value will be displayed only if the category of PAN is 'Individual', If other than
Individual value to be dispalyed as 'Not Applicable(NA)' 3. Data to
be displayed for status E and E along with event
[Data to be displayed for status E and E along with event]
Name on card [Data to be displayed for status E and E along with
event] information will be displayed for status E and E
Below
along with event.

Y – Operative PAN
R - Inoperative PAN
NA - For all non-
Individual PANs
Reserved for future use and will not have any value
As provided by user in request

Internal Use Page 1

 TAN Extract file format Ver. 1.0

“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” in ITD
database
"EC" - Existing and Valid but event marked as “Acquisition” in ITD
database
"ED" - Existing and Valid but event marked as “Death” in ITD database
"EI" - Existing and Valid but event marked as “Dissolution” in ITD
database
"EL" - Existing and Valid but event marked as “Liquidated” in ITD
database
"EM" - Existing and Valid but event marked as “Merger” in ITD
database
"EP" - Existing and Valid but event marked as “Partition” in ITD
database
"ES" - Existing and Valid but event marked as “Split” in ITD database
"EU" - Existing and Valid but event marked as “Under Liquidation” in
ITD database

[Data to be displayed for status E and E along with event]

[Data to be displayed for status E and E along with event]
[Data to be displayed for status E and E along with event]
[Data to be displayed for status E and E along with event]
1. DOB as present in ITD database will be displayed. 2.
The date will be in DD/MM/YYYY format.
3. Data to be displayed for status E and E along with event
1. Value as present in ITD database will be displayed. 2.
Value will be displayed only if the category of PAN is 'Individual', If other than
Individual value to be dispalyed as 'Not Applicable(NA)' 3. Data to
be displayed for status E and E along with event
1. Value as present in ITD database will be displayed. 2.
Value will be displayed only if the category of PAN is 'Individual', If other than
Individual value to be dispalyed as 'Not Applicable(NA)' 3. Data to
be displayed for status E and E along with event
1. Value as present in ITD database will be displayed. 2.
Value will be displayed only if the category of PAN is 'Individual', If other than
Individual value to be dispalyed as 'Not Applicable(NA)' 3. Data to
be displayed for status E and E along with event
[Data to be displayed for status E and E along with event]
Name on card [Data to be displayed for status E and E along with
event]

Internal Use Page 1

 TAN Extract file format Ver. 1.0
Below information will be displayed for status E and E
along with event.

Y – Operative PAN
R - Inoperative PAN
NA - For all non-
Individual PANs
Reserved for future use and will not have any value
As provided by user in request

“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” in ITD
database
"EC" - Existing and Valid but event marked as “Acquisition” in ITD
database
"ED" - Existing and Valid but event marked as “Death” in ITD database
"EI" - Existing and Valid but event marked as “Dissolution” in ITD
database
"EL" - Existing and Valid but event marked as “Liquidated” in ITD
database
"EM" - Existing and Valid but event marked as “Merger” in ITD
database
"EP" - Existing and Valid but event marked as “Partition” in ITD
database
"ES" - Existing and Valid but event marked as “Split” in ITD database
"EU" - Existing and Valid but event marked as “Under Liquidation” in
ITD database

[Data to be displayed for status E and E along with event]

[Data to be displayed for status E and E along with event]
[Data to be displayed for status E and E along with event]
[Data to be displayed for status E and E along with event]
1. DOB as present in ITD database will be displayed. 2.
The date will be in DD/MM/YYYY format.
3. Data to be displayed for status E and E along with event
1. Value as present in ITD database will be displayed. 2.
Value will be displayed only if the category of PAN is 'Individual', If other than
Individual value to be dispalyed as 'Not Applicable(NA)' 3. Data to
be displayed for status E and E along with event
1. Value as present in ITD database will be displayed. 2.
Value will be displayed only if the category of PAN is 'Individual', If other than
Individual value to be dispalyed as 'Not Applicable(NA)' 3. Data to
be displayed for status E and E along with event

Internal Use Page 1

 TAN Extract file format Ver. 1.0

1. Value as present in ITD database will be displayed. 2.

Value will be displayed only if the category of PAN is 'Individual', If other than
Individual value to be dispalyed as 'Not Applicable(NA)' 3. Data to
be displayed for status E and E along with event
[Data to be displayed for status E and E along with event]
Name on card [Data to be displayed for status E and E along with
Below information will be displayed for status E and E
event]
along with event.

Y – Operative PAN
R - Inoperative PAN
NA - For all non-
Individual PANs
Reserved for future use and will not have any value
As provided by user in request

“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” in ITD
database
"EC" - Existing and Valid but event marked as “Acquisition” in ITD
database
"ED" - Existing and Valid but event marked as “Death” in ITD database
"EI" - Existing and Valid but event marked as “Dissolution” in ITD
database
"EL" - Existing and Valid but event marked as “Liquidated” in ITD
database
"EM" - Existing and Valid but event marked as “Merger” in ITD
database
"EP" - Existing and Valid but event marked as “Partition” in ITD
database
"ES" - Existing and Valid but event marked as “Split” in ITD database
"EU" - Existing and Valid but event marked as “Under Liquidation” in
ITD database

[Data to be displayed for status E and E along with event]

[Data to be displayed for status E and E along with event]
[Data to be displayed for status E and E along with event]
[Data to be displayed for status E and E along with event]
1. DOB as present in ITD database will be displayed. 2.
The date will be in DD/MM/YYYY format.
3. Data to be displayed for status E and E along with event

Internal Use Page 1

 TAN Extract file format Ver. 1.0

1. Value as present in ITD database will be displayed. 2.

Value will be displayed only if the category of PAN is 'Individual', If other than
Individual value to be dispalyed as 'Not Applicable(NA)' 3. Data to
be displayed for status E and E along with event
1. Value as present in ITD database will be displayed. 2.
Value will be displayed only if the category of PAN is 'Individual', If other than
Individual value to be dispalyed as 'Not Applicable(NA)' 3. Data to
be displayed for status E and E along with event
1. Value as present in ITD database will be displayed. 2.
Value will be displayed only if the category of PAN is 'Individual', If other than
Individual value to be dispalyed as 'Not Applicable(NA)' 3. Data to
be displayed for status E and E along with event
[Data to be displayed for status E and E along with event]
Name on card [Data to be displayed for status E and E along with
event] information will be displayed for status E and E
Below
along with event.

Y – Operative PAN
R - Inoperative PAN
NA - For all non-
Individual PANs
Reserved for future use and will not have any value

Internal Use Page 1

Return Codes
S No Error Code Error Description
1 1 Success
2 2 System Error
3 3 Authentication Failure
4 4 User not authorized
5 5 No PANs Entered
6 6 User validity has expired
7 7 Number of PANs exceeds the limit (5)
8 8 Not enough balance
9 9 Not an HTTPs request
10 10 POST method not used
11 11 SLAB_CHANGE_RUNNING
12 12 Invalid version number entered
User ID not sent in Input request and only
15 15 PAN sent
Certificate Revocation List issued by the
16 16 Certifying Authorities is expired
17 17 User id Deactivated
User ID not present in database or Wrong
18 18 certificate used
19 19 Signature sent in input request is blank
20 20 User ID and PAN not sent in Input request
21 21 Only ^ sent in Input request