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"
}

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
Request body for PAN Lite

Find the request parameters 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

Success response for verifying PAN 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"

Was this page helpful?