Skip to main content
GET
/
pan
/
{reference_id}
Get Status
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

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

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

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"