Skip to main content
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"
}
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

​
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<int64>

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"