POST
/
pan
/
advance
curl --request POST \
  --url https://sandbox.cashfree.com/verification/pan/advance \
  --header 'Content-Type: application/json' \
  --header 'x-client-id: <api-key>' \
  --header 'x-client-secret: <api-key>' \
  --data '{
  "pan": "AZJPG7110R",
  "verification_id": "testverificationid",
  "name": "JOHN SNOW"
}'
{
  "status": "VALID",
  "message": "PAN verified successfully",
  "reference_id": 21637861,
  "verification_id": "testverificationId",
  "name_provided": "JOHN SNOW",
  "pan": "LMNCD8010T",
  "registered_name": "JOHN SNOW",
  "name_pan_card": "JOHN SNOW",
  "first_name": "JOHN",
  "last_name": "SNOW",
  "type": "Individual or Person",
  "gender": "Male",
  "date_of_birth": "27-10-2004",
  "masked_aadhaar_number": "XXXXXXXX8848",
  "email": "abc@gmail.com",
  "mobile_number": "99999999999",
  "aadhaar_linked": true,
  "address": {
    "full_address": "Quarter - A, Block - B Sample Area, ABC Street 700011 KOLKATA WEST BENGAL INDIA",
    "street": "ABC Street",
    "city": "KOLKATA",
    "state": "WEST BENGAL",
    "pincode": 700011,
    "country": "India"
  }
}

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

Body

application/json
Find the request parameters to retrieve the PAN information

Find the request parameters to verify PAN information

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

"AZJPG7110R"

verification_id
string
default:testverificationid
required

It is the unique ID you create to identify the verification request. The maximum character limit is 50. Only alphanumeric, period (.), hyphen (-), and underscore ( _ ) are allowed.

Example:

"testverificationid"

name
string
default:JOHN SNOW

It is the name of the PAN information holder.

Example:

"JOHN SNOW"

Response

200
application/json
Success response for retrieving the PAN information

Success response for PAN Advance

reference_id
integer

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

Example:

1358

verification_id
string

It displays the unique ID you created to identify the verification request.

Example:

"testverificationid"

status
string

It displays the status of the API request. Possible values are

  • VALID: The provided PAN is valid.
  • INVALID: The provided PAN is invalid.
Example:

"VALID"

message
string

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

Example:

"PAN verified successfully"

pan
string

It displays the PAN information entered in the API request.

Example:

"AZJPG7110R"

name_provided
string

It displays the name entered in the API request.

Example:

"JOHN SNOW"

registered_name
string

It displays the registererd name as present in the PAN information.

Example:

"JOHN SNOW"

name_pan_card
string

It displays the name as present in the PAN information.

Example:

"JOHN SNOW"

first_name
string

It displays the first name as present in the PAN information.

Example:

"JOHN"

last_name
string

It displays the last name as present in the PAN information.

Example:

"SNOW"

type
string

It displays the type of the PAN issued.

Example:

"Individual or Person"

gender
string

It displays the gender of the individual as present in the PAN information.

Example:

"Male"

date_of_birth
string

It displays the date of birth of the individual.

Example:

"01/02/1990"

masked_aadhaar_number
string

It displays the masked aadhaar number of the individual.

Example:

"XXXXXXXX8848"

email
string

It displays the email ID of the individual.

Example:

"abc@gmail.com"

mobile_number
string

It displays the mobile number of the individual.

Example:

"9999999999"

aadhaar_linked
boolean

It displays the aadhaar and PAN link status.

Example:

true

address
object

It displays the address information of the individual.

Example:
{
  "full_address": "Quarter - A, Block - B Sample Area, ABC Street 700011 KOLKATA WEST BENGAL INDIA",
  "street": "ABC Street",
  "city": "KOLKATA",
  "state": "WEST BENGAL",
  "pincode": 700011,
  "country": "India"
}