PAN 360

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": "a*[email protected]",
  "mobile_number": "99XXXXXX99",
  "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"
  }
}

PAN

PAN 360

Use this API to verify the PAN information of your customers. You can retrieve more information such as first name, last name, masked aadhaar number,masked email, masked mobile number and other contact information and more. Mobile number ,email and address fields will have fill rate around 45% based on the recent changes to the source of the information. View the test data and use the information to trigger the validations. The test data are usable only in the test environments such as sandbox.

POST

pan

advance

PAN 360

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": "a*[email protected]",
  "mobile_number": "99XXXXXX99",
  "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"
  }
}

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

Body

application/json

Find the request parameters to retrieve the 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

Success response for retrieving the PAN information

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

This refers to the name officially registered with the PAN database.

Example:

"JOHN SNOW"

name_pan_card

string

This refers to the name as it appears on the physical PAN card.

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"

string

It displays the masked email ID of the individual.

Example:

"a*[email protected]"

mobile_number

string

It displays the masked mobile number of the individual.

Example:

"99XXXXXX99"

aadhaar_linked

boolean

It displays the aadhaar and PAN link status.

Example:

true

address

object

It displays the address information of the individual.

Show child attributes

address.full_address

string

It displays the complete address of the individual.

Example:

"Quarter - A, Block - B Sample Area, ABC Street 700011 KOLKATA WEST BENGAL INDIA"

address.street

string

It displays the street name from the individual's address.

Example:

"ABC Street"

address.city

string

It displays the city name from the individual's address.

Example:

"KOLKATA"

address.state

string

It displays the state name from the individual's address.

Example:

"WEST BENGAL"

address.pincode

integer

It displays the PIN code from the individual's address.

Example:

700011

address.country

string

It displays the country name from the individual's address.

Example:

"India"

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

PAN Lite Integration Overview

⌘I

Secure ID APIs

V2

V1 (Depricated API's)

PAN 360

Authorizations

Headers

Body

Response