PAN to GST API

4 min

Introduction

The PAN to GST API is a powerful tool that simplifies the process of verifying and extracting Goods and Services Tax (GST) information based on the Permanent Account Number (PAN). The PAN is a unique identifier assigned to taxpayers in India, while the GST number is essential for businesses operating within the GST framework. With the need to validate GST compliance and obtain accurate GST details, the PAN to GST API offers a reliable and efficient solution.

curl --request POST \
  --url http://preproduction.signzy.tech/api/v2/patrons/..your-patron-id../gstns \
  --header 'Accept: */*' \
  --header 'Accept-Language: en-US,en;q=0.8' \
  --header 'Authorization: <Access-Token>' \
  --header 'content-type: application/json' \
  --data '{"task":"panSearch","essentials":{"panNumber":"...panNumber...","state":"...state...","email":"...email..."}}'

Request Parameters

Parameter	Description
task	Specifies the task to be performed by the API. In this case, "panSearch" indicates a search based on the PAN number.
essentials	An object containing essential parameters for the PAN search.
panNumber	The PAN number for which the GST information is to be retrieved.
state	The state associated with the PAN.
email	The email address associated with the PAN.

Valid State List

State
ANDAMAN AND NICOBAR ISLANDS
ANDHRA PRADESH
ARUNACHAL PRADESH
ASSAM
BIHAR
CHANDIGARH
CHATTISGARH
DADRA AND NAGAR HAVELI AND DAMAN AND DIU
DAMAN AND DIU
DELHI
GOA
GUJARAT
HARYANA
HIMACHAL PRADESH
JAMMU AND KASHMIR
JHARKHAND
KARNATAKA
KERALA
LAKSHADWEEP ISLANDS
LADAKH
MADHYA PRADESH
MAHARASHTRA
MANIPUR
MEGHALAYA
MIZORAM
NAGALAND
ODISHA
PONDICHERRY
PUNJAB
RAJASTHAN
SIKKIM
TAMIL NADU
TELANGANA
TRIPURA
UTTAR PRADESH
UTTARAKHAND
WEST BENGAL
ANDHRA PRADESH (NEW)

Sample Response

{
  "task": "panSearch",
  "essentials": {
    "panNumber": "..panNumber..",
    "state": "..state..",
    "email": "..email.."
  },
  "id": "...accessToken...",
  "patronId": "...patronId...",
  "result": {
    "gstnRecords": [
      {
        "tinNumber": "...tinNumber...",
        "regType": "...regType...",
        "gstinRefId": "...gstinRefId...",
        "applicationStatus": "...applicationStatus...",
        "registrationName": "...registrationName...",
        "mobNum": "...mobNum...",
        "emailId": "...emailId...",
        "gstin": "...gstin...",
      }
    ],
    "gstnDetailed": [
      [
        {
          "constitutionOfBusiness": "...constitutionOfBusiness...",
          "legalNameOfBusiness": "...legalNameOfBusiness...",
          "tradeNameOfBusiness": "...tradeNameOfBusiness...",
          "centreJurisdiction": "...centreJurisdiction...",
          "stateJurisdiction": "...stateJurisdiction...",
          "registrationDate": "...registrationDate...",
          "taxPayerDate": "...taxPayerDate...",
          "taxPayerType": "...taxPayerType...",
          "gstinStatus": "...gstinStatus...",
          "cancellationDate": "...cancellationDate...",
          "e-invoicingStatus":"...e-invoicingStatus...",
          "natureOfBusinessActivities": [],
          "principalPlaceAddress": "...principalPlaceAddress...",
          "principalPlaceLatitude": "...principalPlaceLatitude...",
          "principalPlaceLongitude": "...principalPlaceLongitude...",
          "principalPlaceBuildingNameFromGST": "...principalPlaceBuildingNameFromGST...",
          "principalPlaceBuildingNoFromGST": "...principalPlaceBuildingNoFromGST...",
          "principalPlaceFlatNo": "...principalPlaceFlatNo...",
          "principalPlaceStreet": "...principalPlaceStreet...",
          "principalPlaceLocality": "...principalPlaceLocality...",
          "principalPlaceCity": "...principalPlaceCity...",
          "principalPlaceDistrict": "...principalPlaceDistrict...",
          "principalPlaceState": "...principalPlaceState...",
          "principalPlacePincode": "...principalPlacePincode...",
          "additionalPlaceAddress": "...additionalPlaceAddress...",
          "additionalPlaceLatitude": "...additionalPlaceLatitude...",
          "additionalPlaceLongitude": "...additionalPlaceLongitude...",
          "additionalPlaceBuildingNameFromGST": "...additionalPlaceBuildingNameFromGST...",
          "additionalPlaceBuildingNoFromGST": "...additionalPlaceBuildingNoFromGST...",
          "additionalPlaceFlatNo": "...additionalPlaceFlatNo...",
          "additionalPlaceStreet": "...additionalPlaceStreet...",
          "additionalPlaceLocality": "...additionalPlaceLocality...",
          "additionalPlaceCity": "...additionalPlaceCity...",
          "additionalPlaceDistrict": "...additionalPlaceDistrict...",
          "additionalPlaceState": "...additionalPlaceState...",
          "additionalPlacePincode": "...additionalPlacePincode...",
          "gstin": "...gstin...",
          "lastUpdatedDate": "...lastUpdatedDate...",
          "additionalPlaceSplitAddress": {
            "district": [],
            "state": [
              []
            ],
            "city": [],
            "pincode": "...pincode...",
            "country": [],
            "addressLine": "...addressLine...",
          },
          "additionalAddressArray": [{
              "address": "...address...",
              "flatNo": "...flatNo...",
              "street": "...street...",
              "locality": "...locality...",
              "buildingNo": "...buildingNo...",
              "buildingName": "...buildingName...",
              "district": "...district...",
              "city": "...city...",
              "state": "...state...",
              "pincode": "...pincode...",
              "latitude": "...latitude...",
              "longitude": "...longitude..."
          }],
          "principalPlaceSplitAddress": {
              "district": [],
              "state": [
                []
              ],
              "city": [],
              "pincode": "...pincode...",
              "country": [
                "IN",
                "IND",
                "INDIA"
              ],
              "addressLine": "...addressLine...",
            }
          }
        ]
      ]
    }
  }