Request Method :: POST

Description: The PAN Verification API is used to validate the authenticity of a user's Permanent Account Number (PAN).

Headers

---

Content-Type: application/JSON

header_secrets:  To be shared during integration by ISU Team

pass_key:  To be shared during integration by ISU Team

Request Body Parameters

Parameters	Description and Example	Data type	Mandatory/Optional
pan	This is user PAN Number. E.g.- AAAPA0039K	varchar	Mandatory
name	Name is a combination of first name, middle name, last name, or Name on the card. E.g.- Rajesh ramdin gupta	varchar	Mandatory
fathername	User will provide father's Name (It is a combination of father’s first name, middle name, and last name.	varchar	Optional
dob	It will be format of (DD/MM/YYYY) and it should be separated with a slash (/). E.g. - 09/02/1928	date	Mandatory

Sample Request Body

---

{ "panDetails": { "pan": "AAAPA0039K", "name": "Rajesh ramdin gupta", "fathername": "", "dob": "18/10/1989" } }

Encrypted Sample Request Body

---

{ "RequestData": "0xOhi1Ipn/WeoHN8mbP77uLUeW74iv/ JXz7O3Nn5fnhHZ4JZioaIh6cNPNshcx2ImM3XZhp6/DTS6jGVmMeVYCi8EhzA0iefG87HoZY/ czzvdkVHFSBADgAz/kd3jHeTX1SJDiIUmH54MBaWIHYGxtfrr+hGjhLGhOH3TzJTvMw=" }

Response Body Parameters

Parameters	Parameter description with examples	Data type
status	Status Identifier of the operation (0 - SUCCESS and1- FAILED)	string
statusDesc	Status description of the operation	string
statusCode	Status code of the operation	Integer
data	Data fetched for the provided valid details.	Object
response_Code	Response Code (For SUCCESS response only)	string
outputData	Fetched PAN Details (For SUCCESS response only).	array
pan	Fetched PAN (For SUCCESS response only)	String
pan_status	PAN Status (For SUCCESS response only)	string
name	PAN holder’s name (For SUCCESS response only).	string
fathername	PAN holder’s father’s name (For SUCCESS response only)	string
dob	Date of Birth of the PAN holder (For SUCCESS response only)	string
seeding_status	Seeding Status (For SUCCESS response only)	string
type	Error Type (For FAILED response only)	String
value	Error Value (For FAILED response only)	string
msg	Message describing the Error (For FAILED response only)	String
path	Path of the Error (For FAILED response only)	string
location	Location where the Error is (For FAILED response only).	String

Sample Response Body

---

SUCCESS:

{ "status": "SUCCESS", "statusDesc": " Existing and Valid ", "data": { "response_Code": "1", "outputData": [ { "pan": "AAAPA0039K", "pan_status": "E", "name": "Y", "fathername": "", "dob": "Y", "seeding_status": "Y" } ] } }

Encrypted Sample Response Body

---

{ "ResponseData": "GLCP6vbpKUhDXJDT33s+upudqqRHpdNUDY9MNwmkFLsVc5uyA3lVzf97MTo0rDjrMQPzvqFCxyGA2ixOH g54Bdg1rWAJGwqkF8n+15R3I5DDMpmIs9vQ/ uQo41T57vECFxD6ZbTLWN8AyThn0qiycEGHr75TF0zq8ZPKU9D7x44DJkhvQbMXY9Nf6dQVRxkmJXiO11A bxrb2UvCOX2h9lGyO5feAhcD6uT1QqFiEz4JioTnffrSF/ FDmbEcVFkpWVE9MAgjW8c9EN74UNHY6CPwRdU8/7ymsOVbmeZbFtDh7sWvYUCwHU4UEL0bAh+1b" }

 

FAILED(PAN is missing):

{ "statusCode": -1, "status": "INVALID REQUEST", "statusDesc": "PAN number is required", "data": [ { "type": "field", "value": "", "msg": "PAN number is required", "path": "panDetails.pan", "location": "body" } ] }

FAILED(Name is missing):

{ "data": [ { "type": "field", "value": "", "msg": "Name is required", "path": "panDetails.name", "location": "body" } ], "statusCode": -1, "status": "INVALID REQUEST", "statusDesc": "Name is required" }

FAILED(DOB is missing):

{ "data": [ { "type": "field", "value": "", "msg": "DOB is required", "path": "panDetails.dob", "location": "body" } ], "statusCode": -1, "status": "INVALID REQUEST", "statusDesc": "DOB is required" }

Detailed Status Codes

Status Code	Status	Description
0	SUCCESS	Existing and Valid
-1	FAILED	PAN number is required
-1	FAILED	DOB is required