POST
/
pan
Verify
curl --request POST \
  --url https://sandbox.cashfree.com/verification/pan \
  --header 'Content-Type: application/json' \
  --header 'x-client-id: <api-key>' \
  --header 'x-client-secret: <api-key>' \
  --data '{
  "pan": "ABCPV1234D",
  "name": "Gurav"
}'
{
  "pan": "ABCPV1234D",
  "type": "Individual",
  "reference_id": 161,
  "name_provided": "JOHN DOE",
  "registered_name": "JOHN DOE",
  "valid": true,
  "message": "PAN verified successfully",
  "name_match_score": 100,
  "name_match_result": "DIRECT_MATCH",
  "aadhaar_seeding_status": "Y",
  "last_updated_at": "01/01/2019",
  "name_pan_card": "JOHN DOE",
  "pan_status": "VALID",
  "aadhaar_seeding_status_desc": "Aadhaar is linked to PAN"
}

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

​
x-api-version
string

It is the API version. To receive the aadhaar seeding status in the response, use any date after 2022-09-12

Body

application/json

Find the request parameters to verify PAN.

​
pan
string
default:ABCPV1234D
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:

"ABCPV1234D"

​
name
string
default:Gurav

It is the name of the individual.

Example:

"Gurav"

Response

Success response for verifiying PAN information

​
pan
string

It displays the unique 10-character alphanumeric identifier issued by the Income Tax Department.

Example:

"ABCPV1234D"

​
type
string

It displays the type of the PAN issued.

Example:

"Individual"

​
reference_id
integer

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

Example:

161

​
name_provided
string

It displays the name entered in the API request.

Example:

"JOHN DOE"

​
registered_name
string

It displays the PAN registered name.

Example:

"JOHN DOE"

​
valid
boolean

It displays the status of the PAN card.

Example:

true

​
father_name
string

It displays the father's name of the PAN card holder.

Example:

""

​
message
string

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

Example:

"PAN verified successfully"

​
name_match_score
string

It displays the score for the name match verification.

Example:

"100.00"

​
name_match_result
string

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

  • DIRECT_MATCH
  • GOOD_PARTIAL_MATCH
  • MODERATE_PARTIAL_MATCH
  • POOR_PARTIAL_MATCH
  • NO_MATCH
Example:

"DIRECT_MATCH"

​
aadhaar_seeding_status
string

It displays additional information of the linking of aadhaar and PAN card. 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"

​
last_updated_at
string

It displays the last updated date.

Example:

"01/01/2019"

​
name_pan_card
string

It displays the name displayed on the PAN card.

Example:

"JOHN DOE"

​
pan_status
string

It displays the status of the PAN card. Possible values are:

  • VALID
  • INVALID
  • DELETED
  • DEACTIVATED
Example:

"VALID"

​
aadhaar_seeding_status_desc
string

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

Example:

"Aadhaar is linked to PAN"