GSTIN Search API

3 min

Introduction

The GSTIN Search API provides a straightforward method to retrieve Goods and Services Tax (GST) details by searching for a specific GST Identification Number (GSTIN). GSTIN is a unique identification number assigned to registered taxpayers in India. With this API, developers can seamlessly integrate GSTIN search functionality into their applications, enabling users to obtain accurate and up-to-date GST information effortlessly.

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":"gstnSearch","essentials":{"gstin":"...gstin..."}}'

Request Parameters

Parameter	Description
task	Specifies the task to be performed by the API. In this case, "gstnSearch" indicates searching based on GSTIN.
essentials	An object containing essential parameters for the GSTIN search.
gstin	The GST Identification Number (GSTIN) for which the GST details are to be retrieved.

Sample Response

{
    "result":{
       "gstnRecords":[
          {
             "regType":"..registrationType...",
             "emailId":"..emailId...",
             "applicationStatus":"...application Status...",
             "registrationName":"...registered Name...",
             "gstinRefId":"...GSTIN Reference Id...",
             "tinNumber":"...Tin Number...",
             "mobNum":"...Mobile Number...",
             "gstin":"...gstin Number..."
          }
       ],
       "gstnDetailed":{
          "constitutionOfBusiness":"....Constitution Of Business...",
          "legalNameOfBusiness":"....Name Of Business...",
          "tradeNameOfBusiness":"....Trade Name Of Business...",
          "centreJurisdiction":"....Centre Of Jurisdiction...",
          "stateJurisdiction":"....State Of Jurisdiction...",
          "registrationDate":"...Date of Registration...",
          "taxPayerDate":"...Tax Payer Date...",
          "taxPayerType":"...Tax Payer Type...",
          "gstinStatus":"..GSTIN Status...",
          "cancellationDate":"..cancellation Date...",
          "e-invoicingStatus":"...e-invoicingStatus...",
          "natureOfBusinessActivities":[
             "...Nature of Business Activities..."
          ],
          "principalPlaceAddress":"...Principal Address of the entity registered in GST...",
          "principalPlaceLatitude":"...Principal Latitude of the entity registered in GST...",
          "principalPlaceLongitude":"...Principal Longitude of the entity registered in GST...",
          "principalPlaceBuildingNameFromGST":"...Bulding Name of Principal Address of the entity registered in GST...",
          "principalPlaceBuildingNoFromGST":"...Bulding No of Principal Address of the entity registered in GST...",
          "principalPlaceFlatNo":"...Flat No of Principal Address of the entity registered in GST...",
          "principalPlaceStreet":"...Street of Principal Address of the entity registered in GST...",
          "principalPlaceLocality":"...Locality of Principal Address of the entity registered in GST...",
          "principalPlaceCity":"...City of Principal Address of the entity registered in GST...",
          "principalPlaceDistrict":"...District of Principal Address of the entity registered in GST...",
          "principalPlaceState":"...State of Principal Address of the entity registered in GST...",
          "principalPlacePincode":"...Pincode of Principal Address of the entity registered in GST...",
          "additionalPlaceAddress":"...Additional Address of the entity registered in GST...",
          "additionalPlaceLatitude":"...Additional Latitude of the entity registered in GST...",
          "additionalPlaceLongitude":"...Additional Longitude of the entity registered in GST...",
          "additionalPlaceBuildingNameFromGST":"...Bulding Name of Additional Address of the entity registered in GST...",
          "additionalPlaceBuildingNoFromGST":"...Bulding No of Additional Address of the entity registered in GST...",
          "additionalPlaceFlatNo":"...Flat No of Additional Address of the entity registered in GST...",
          "additionalPlaceStreet":"...Street of Additional Address of the entity registered in GST...",
          "additionalPlaceLocality":"...Locality of Additional Address of the entity registered in GST...",
          "additionalPlaceCity":"...City of Additional Address of the entity registered in GST...",
          "additionalPlaceDistrict":"...District of Additional Address of the entity registered in GST...",
          "additionalPlaceState":"...State of Additional Address of the entity registered in GST...",
          "additionalPlacePincode":"...Pincode of Additional Address of the entity registered in GST...",
          "principalPlaceSplitAddress":{
             "state":[
                [
                   
                ]
             ],
             "district":[
                
             ],
             "city":[
                
             ],
             "pincode":"...pincode...",
             "country":[
                "IN",
                "IND",
                "INDIA"
             ],
             "addressLine":"...addressLine..."
          },
          "additionalPlaceSplitAddress":{
             "state":[
                [
                   
                ]
             ],
             "district":[
                
             ],
             "city":[
                
             ],
             "pincode":"...pincode...",
             "country":[
                "IN",
                "IND",
                "INDIA"
             ],
             "addressLine":"...addressLine..."
          },
          "additionalAddressArray":[
             {
                "address":"...address...""street":"...street...",
                "locality":"...locality...",
                "buildingNo":"...buildingNo...",
                "buildingName":"...buildingName...",
                "district":"...district...",
                "city":"...city...",
                "state":"...state...",
                "flatNo":"...flatNo...",
                "latitude":"...latitude...",
                "pincode":"...pincode...",
                "longitude":"...longitude..."
             }
          ]
       },
       "lastUpdatedDate":"...lastUpdatedDate...",
       "gstin": "...gstin Number..."
     }
   }