PAN Lite

Use this API to validate PAN information of individuals. The API helps verify the unique identifier, name of the individual, date of birth, and other information that helps you in customer onboarding, KYC verification, and other fraud prevention security measures. View the test data and use the information to trigger the validations.You can use the test data only in sandbox environment.

Authorizations

x-client-id · string · header · required

Your unique client identifier issued by Cashfree. You can find this in your Merchant Dashboard.

x-client-secret · string · header · required

The secret key associated with your client ID. Use this to authenticate your API requests. You can find this in your Merchant Dashboard.

Headers

x-cf-signature · string

Send the signature if two-factor authentication is selected as Public Key. More details

Body

application/json

Request body for PAN Lite

verification_id · string · default: test001 · required

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

Example:

"test001"

pan · string · default: ABCTY1234D · 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:

"ABCTY1234D"

name · string · default: John Doe · required

It is the name of the individual as per the PAN information

Example:

"John Doe"

dob · string · default: 1993-06-30 · required

It is the date of birth of the individual as per the PAN information. The format is YYYY-MM-DD

Example:

"1993-06-30"

Response

200

application/json

Success response for retrieving PAN Lite information

reference_id · integer

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

Example:

21637861

verification_id · string

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

Example:

"test001"

pan · string

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:

"ABCTY1234D"

name · string

It is the name of the individual as per the PAN information

Example:

"John Doe"

dob · string

It is the date of birth of the individual as per the PAN information. The format is YYYY-MM-DD

Example:

"1993-06-30"

name_match · string

It displays the result of name match verification. The possible values are:

• Y : The name entered matches with the name present on the PAN.

• N : The name entered does matches with the name present on the PAN.

Example:

"Y"

dob_match · string

It displays the result of the date of birth verification. The possible values are:

• Y : The date of birth of the individual matches with the date of birth present on PAN.

• N : The date of birth of the individual does not matches with the date of birth present on PAN.

Example:

"Y"

pan_status · string

It displays the status of the PAN information. The possible values are:

• E : The entered PAN information is valid.

• EC: The entered PAN information exists and is valid but marked as Acquisition.

• N : The entered PAN information does not exist in the database.

• X : The entered PAN information has been deactivated.

• F : The entered PAN information is fake.

• D : The entered PAN information has been deleted.

• EA : The entered PAN information is valid but marked as Amalgamation.

• ED : The entered PAN information is valid but marked as Death.

• EI : The entered PAN information is valid but marked as Dissolution.

• EL : The entered PAN information is valid but marked as Liquidated.

• EM : The entered PAN information is valid but marked as Merger.

• EP : The entered PAN information is valid but marked as Partition.

• ES : The entered PAN information is valid but marked as Split.

• EU : The entered PAN information is valid but marked as Under Liquidation.

Example:

"E"

status · string

It displays status of PAN. The Possible Values are:

• VALID
• INVALID

Example:

"VALID"

aadhaar_seeding_status · string

It displays whether the individual linked the aadhaar information with PAN. The possible values are:

• Y: Aadhaar is linked to PAN
• R: Aadhaar is not linked to PAN
• NA: Not applicable, in case of business PAN

Example:

"Y"

aadhaar_seeding_status_desc · string

It displays additional information of the linking of aadhaar and PAN card.

Example:

"Aadhaar is linked to PAN"