Skip to main content
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"
}
'
import requests

url = "https://sandbox.cashfree.com/verification/pan/advance"

payload = {
    "pan": "AZJPG7110R",
    "verification_id": "testverificationid",
    "name": "JOHN SNOW"
}
headers = {
    "x-client-id": "<api-key>",
    "x-client-secret": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
const options = {
  method: 'POST',
  headers: {
    'x-client-id': '<api-key>',
    'x-client-secret': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({pan: 'AZJPG7110R', verification_id: 'testverificationid', name: 'JOHN SNOW'})
};

fetch('https://sandbox.cashfree.com/verification/pan/advance', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://sandbox.cashfree.com/verification/pan/advance",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'pan' => 'AZJPG7110R',
    'verification_id' => 'testverificationid',
    'name' => 'JOHN SNOW'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-client-id: <api-key>",
    "x-client-secret: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://sandbox.cashfree.com/verification/pan/advance"

	payload := strings.NewReader("{\n  \"pan\": \"AZJPG7110R\",\n  \"verification_id\": \"testverificationid\",\n  \"name\": \"JOHN SNOW\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-client-id", "<api-key>")
	req.Header.Add("x-client-secret", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.post("https://sandbox.cashfree.com/verification/pan/advance")
  .header("x-client-id", "<api-key>")
  .header("x-client-secret", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"pan\": \"AZJPG7110R\",\n  \"verification_id\": \"testverificationid\",\n  \"name\": \"JOHN SNOW\"\n}")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://sandbox.cashfree.com/verification/pan/advance")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-client-id"] = '<api-key>'
request["x-client-secret"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"pan\": \"AZJPG7110R\",\n  \"verification_id\": \"testverificationid\",\n  \"name\": \"JOHN SNOW\"\n}"

response = http.request(request)
puts response.read_body
{
  "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*c@gmail.com",
  "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 Doe

It is the name of the individual as per the PAN records. In case of special characters, only space, dot (.), hyphen (-), slash (/), and ampersand (&) are allowed.

Example:

"John Doe"

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"

​
email
string

It displays the masked email ID of the individual.

Example:

"a*c@gmail.com"

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

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