PAN 360

Use this API to verify the PAN information of your customers. You can retrieve more information such as first name, last name, masked aadhaar number,masked email, masked mobile number and other contact information and more. Mobile number ,email and address fields will have fill rate around 45% based on the recent changes to the source of the information. View the test data and use the information to trigger the validations. The test data are usable only in the test environments such as sandbox.

Authorizations

x-client-id · string · header · required

Client ID. You can find your ID in the Merchant Dashboard.

x-client-secret · string · header · required

Client secret key. You can find your secret key in the Merchant Dashboard.

Headers

x-cf-signature · string

Send the signature if IP is not whitelisted

Body

application/json

Find the request parameters to retrieve the PAN information

Find the request parameters to verify PAN information

pan · string · default: AZJPG7110R · required

It is the unique 10-character alphanumeric identifier of the individual issued by the Income Tax Department. The first 5 should be alphabets followed by 4 numbers and the 10th character should again be an alphabet.

Example:

"AZJPG7110R"

verification_id · string · default: testverificationid · required

It is the unique ID you create to identify the verification request. The maximum character limit is 50. Only alphanumeric, period (.), hyphen (-), and underscore ( _ ) are allowed.

Example:

"testverificationid"

name · string · default: JOHN SNOW

It is the name of the PAN information holder.

Example:

"JOHN SNOW"

Response

200

application/json

Success response for retrieving the PAN information

Success response for PAN Advance

reference_id · integer

It displays the unique ID created by Cashfree Payments for reference purposes. format: int64

Example:

1358

verification_id · string

It displays the unique ID you created to identify the verification request.

Example:

"testverificationid"

status · string

It displays the status of the API request. Possible values are

• VALID: The provided PAN is valid.
• INVALID: The provided PAN is invalid.

Example:

"VALID"

message · string

It displays details about the success or failure of the API request.

Example:

"PAN verified successfully"

pan · string

It displays the PAN information entered in the API request.

Example:

"AZJPG7110R"

name_provided · string

It displays the name entered in the API request.

Example:

"JOHN SNOW"

registered_name · string

It displays the registererd name as present in the PAN information.

Example:

"JOHN SNOW"

name_pan_card · string

It displays the name as present in the PAN information.

Example:

"JOHN SNOW"

first_name · string

It displays the first name as present in the PAN information.

Example:

"JOHN"

last_name · string

It displays the last name as present in the PAN information.

Example:

"SNOW"

type · string

It displays the type of the PAN issued.

Example:

"Individual or Person"

gender · string

It displays the gender of the individual as present in the PAN information.

Example:

"Male"

date_of_birth · string

It displays the date of birth of the individual.

Example:

"01/02/1990"

masked_aadhaar_number · string

It displays the masked aadhaar number of the individual.

Example:

"XXXXXXXX8848"

email · string

It displays the email ID of the individual.

Example:

"[e-mail]"

mobile_number · string

It displays the mobile number of the individual.

Example:

"9999999999"

aadhaar_linked · boolean

It displays the aadhaar and PAN link status.

Example:

true

address · object

It displays the address information of the individual.

Show child attributes

Example:

{
  "full_address": "Quarter - A, Block - B Sample Area, ABC Street 700011 KOLKATA WEST BENGAL INDIA",
  "street": "ABC Street",
  "city": "KOLKATA",
  "state": "WEST BENGAL",
  "pincode": 700011,
  "country": "India"
}