GET
/
pan
/
{reference_id}
curl --request GET \
  --url https://sandbox.cashfree.com/verification/pan/{reference_id} \
  --header 'x-client-id: <api-key>' \
  --header 'x-client-secret: <api-key>'
{
  "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

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

​
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

Path Parameters

​
reference_id
string
default:123546
required

It is the unique ID created by Cashfree Payments that you receive in the response of Verify PAN Sync API.

Response

200
application/json
Success response for verifiying PAN information

Success response for Verify PAN Sync API

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

Was this page helpful?