Response Parameters
Plain Response Parameters:
#
Field Name
Description
Type
Max. Length
Mandatory
[Yes/No]
1
SessionID
Client application identifier for the current session if any inputted
String
250
No
2
Status
Response status code
String
100
Yes
3
StatusDecription
Response status description
String
500
Yes
4
PanStatus
Status of the PAN returned by NSDL
String
2
Yes
5
FirstName
PAN holder first name
String
25
No
6
MiddleName
PAN holder middle name
String
25
No
7
LastName
PAN holder last name
String
75
No
8
NameOnCard
Name of the PAN holder as presented in the PAN card
String
85
No
9
Pan
Applicant’s PAN
String
10
No
10
PanTitle
Title of the PAN holder
String
6
No
11
AadhaarSeedingStatus
Aadhaar and PAN liked status for the PAN
String
2
No
12
Res_Ref_No
Application unique ID of current transaction
String
100
Yes
Sample Encrypted Response:
{
LBQBRUWkyFohDaJqnoZTDVTwnHcAFmUBT8Qd53JDpSmAkBTv6n2EE+wAfafJ09tTlKKjFbMPvg+bn7QenvzxN6xvE eUaX2dkjmFax05BCUtxAHIRh0/CY8H97Sx91cS7DOXfiilJN3jXOZcks54vBzbzR/Gz7PTnQJ9Es8ippN1KW2Vx5e JY+zVKR8d/kqgMHMXpal5JtTJ1jV6+FeBh4ydw3yYcB7jJx0uzjCZX6xiXhs/0gaMkxS1chimL6bdfHet00U8T+Fo QBfIXAxi7mYFY+hvXmOag9YYsyFj+hxzeP9yvavdBPN8G342Hds1PtFpWQ9nM08QHioY+k/X/lOwsSLOePw/V9JIe ns+bB+Anm9OrvoeSQMdDN0uuE/iParRhKBDRlgvtZFpMDsk8+LFRgjn6jqiitYr94EguFRI=
}Sample Success Response:
{
"SessionID": "89e8e0b8590345488e8d77f410f733b7",
"Status": "CSS000",
"StatusDecription": "Success",
"PanStatus": "Y",
"FirstName": "Ravi",
"MiddleName": "",
"LastName": "Raja",
"NameOnCard": "Raja R",
"Pan": "ABCPD1234E",
"PanTitle": "Shri",
"AadhaarSeedingStatus": "Y",
"Res_Ref_No": "20220922154302948_gxGbZy7uZb"
}Sample Failure Response:
{
"SessionID": "89e8e0b8590345488e8d77f410f733b7", "Status": "CSS004",
"StatusDecription": "API authentication failed",
"Res_Ref_No": "20220922154442085_UOlJEob2v8"
} Response Status Code and Status Description:
If the request fails, corresponding status code will be returned along with the status description in the response parameter.
The following table lists the possible status codes:
#
Status Code
Status Description
1
CSS000
Success
2
CSS001
Your request decryption failed
3
CSS002
Invalid Request
4
CSS003
User id or password is a mandatory field
5
CSS004
API authentication failed
6
CSS005
Client setup pending
7
CSS006
Client is currently Inactive
8
CSS007
Your password has expired
9
CSS009
Image is empty
10
CSS010
Invalid image format
11
CSS012
We are experiencing technical issues at the moment with one or more of our partners.
Please try again later. Regret inconvenience
12
CSS013
We are unable to process the image. Please check if a lower resolution/sized image can be taken by your system and re-take photo
13
CSS014
We are unable to process your photo. Please re-take.
14
CSS015
Ensure the face is completely visible in the frame and re-take your photo. Face too away from camera
15
CSS016
Ensure the face is completely visible in the frame and re-take your photo. Face too close to camera
16
CSS017
Please ensure the face is completely visible in the photo. We are unable to process the submitted image.
17
CSS018
Session ID is mandatory field
18
CSS019
Invalid Pan
19
CSS035
NSDL PAN not allowed
20
CSS036
NSDL PAN configuration failed
21
CSS022
Pan should not be Empty
22
CSS400
Request is empty
23
CSS500
Internal Error
24
CSS008
Unauthorized API access
Last updated