Skip to main content
POST
/
pan-lite
curl --request POST \
  --url https://sandbox.cashfree.com/verification/pan-lite \
  --header 'Content-Type: application/json' \
  --header 'x-client-id: <api-key>' \
  --header 'x-client-secret: <api-key>' \
  --data '
{
  "verification_id": "test002",
  "pan": "ABCPV1234D",
  "name": "John Doe",
  "dob": "1993-06-30"
}
'
{
  "verification_id": "test001",
  "reference_id": 21637861,
  "pan": "ABCTY1234D",
  "name": "John Doe",
  "dob": "1993-06-30",
  "name_match": "Y",
  "dob_match": "Y",
  "pan_status": "E",
  "status": "VALID",
  "aadhaar_seeding_status": "Y",
  "aadhaar_seeding_status_desc": "Aadhaar is linked to PAN"
}
The name returned by the API may differ from the name printed on the physical PAN card. The API returns the registered name from the Income Tax Department’s records, which is the authoritative source and may not match the name displayed on the card.

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 records. In case of special characters, only space, dot (.), hyphen (-), slash (/), and ampersand (&) are allowed.

Example:

"John Doe"

​
dob
string
default:1993-06-30
required

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

Example:

"1993-06-30"

Response

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"