Skip to main content
POST
/
pan-gstin
Fetch GSTIN with PAN
curl --request POST \
  --url https://sandbox.cashfree.com/verification/pan-gstin \
  --header 'Content-Type: application/json' \
  --header 'x-client-id: <api-key>' \
  --header 'x-client-secret: <api-key>' \
  --data '
{
  "pan": "AZJPG7110R",
  "verification_id": "testverificationid"
}
'
{
  "reference_id": 1358,
  "verification_id": "testverificationid",
  "status": "SUCCESS",
  "pan": "AZJPG7110R",
  "gstin_list": [
    {
      "gstin": "29AAFCD5862R1ZR",
      "status": "ACTIVE",
      "state": "KARNATAKA"
    },
    {
      "gstin": "27AAFCD5862R1ZV",
      "status": "ACTIVE",
      "state": "MAHARASHTRA"
    }
  ]
}

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 list of GSTIN associated with a PAN

​
pan
string
default:AZJPG7110R
required

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

Example:

"AZJPG7110R"

​
verification_id
string
default:testverificationid
required

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

Example:

"testverificationid"

Response

Success response for retrieving the list of GSTIN associated with the entered PAN

​
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 create to identity the verification request.

Example:

"testverificationid"

​
status
string

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

  • SUCCESS: GSTINs associated with the provided PAN were retrieved successfully.
  • GSTIN_NOT_FOUND: No GSTIN is associated with the provided PAN.
Example:

"SUCCESS"

​
pan
string

It displays the entered PAN information in the request.

Example:

"AZJPG7110R"

​
gstin_list
object[]

It displays the list of GSTIN associated with the entered PAN.