POST
/
pan
{
  "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-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.

name
string
default:
Gurav

It is the name of the individual.

Response

200 - application/json

Success response for Verify PAN Sync API

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"
aadhaar_seeding_status_desc
string

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

father_name
string

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

last_updated_at
string

It displays the last updated date.

message
string

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

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
name_match_score
string

It displays the score for the name match verification.

name_pan_card
string

It displays the name displayed on the PAN card.

name_provided
string

It displays the name entered in the API request.

pan
string

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

pan_status
string

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

  • VALID
  • INVALID
  • DELETED
  • DEACTIVATED
reference_id
integer

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

registered_name
string

It displays the PAN registered name.

type
string

It displays the type of the PAN issued.

valid
boolean

It displays the status of the PAN card.

Was this page helpful?