GST and HSN Details API

Introduction

The GST and HSN Details API enables businesses and developers to fetch detailed information for a given GSTIN, including business registration details, compliance data, filing frequency, and HSN (Harmonised System of Nomenclature) codes related to the goods and services offered.

Use this API to enhance compliance workflows, onboard merchants, or enrich internal business records.

API Details

Endpoint

curl --location 'https://api.signzy.app/api/v3/gst/gstAndHsnDetails' \
--header 'Authorization: **************' \
--header 'Content-Type: application/json' \
--data-raw '{
    "gstin": "07***PK4303L1ZY",
    "returnFilingFrequency": "true",
    "filingDataForYears": "1",
    "isPostOffice": "true"
}'

Request Headers

Name	Value	Required	Description
Content-Type	application/json	Mandatory	Specifies the format of the request body.
Authorization	Bearer Token	Mandatory	API token for authentication. Reach out to support team.

Request Body Parameters

Parameter	Data Type	Description	Required
gstin	String	GST Identification Number	Yes
returnFilingFrequency	Boolean	Whether to return the filing frequency data	Optional
filingDataForYears	String	Number of years of filing data to fetch (e.g. "1" for 1 year)	Optional
isPostOffice	Boolean	Whether to include post office information	Optional

Sample Response

{
  "gstin": "string",
  "returnFilingFrequency": true,
  "filingDataForYears": "string",
  "isPostOffice": "string",
  "id": "number",
  "result": {
    "gstnDetailed": {
      "constitutionOfBusiness": "string",
      "legalNameOfBusiness": "string",
      "tradeNameOfBusiness": "string",
      "centreJurisdiction": "string",
      "stateJurisdiction": "string",
      "registrationDate": "YYYY-MM-DD",
      "taxPayerDate": "string",
      "taxPayerType": "string",
      "gstinStatus": "string",
      "cancellationDate": "string",
      "natureOfBusinessActivities": [
        "string"
      ],
      "principalPlaceLatitude": "string",
      "principalPlaceLongitude": "string",
      "principalPlaceStreet": "string",
      "principalPlaceLocality": "string",
      "principalPlaceCity": "string",
      "principalPlaceDistrict": "string",
      "principalPlaceState": "string",
      "principalPlacePincode": "string",
      "additionalPlaceLatitude": "string",
      "additionalPlaceLongitude": "string",
      "additionalPlaceStreet": "string",
      "additionalPlaceLocality": "string",
      "additionalPlaceCity": "string",
      "additionalPlaceDistrict": "string",
      "additionalPlaceState": "string",
      "additionalPlacePincode": "string",
      "complianceRating": "string",
      "additionalPlaceAddress": [
        {
          "emailId": "string",
          "address": "string",
          "natureOfBusiness": "string",
          "mobile": "string",
          "lastUpdatedDate": "string",
          "splitAddress": {
            "district": [
              "string"
            ],
            "state": [
              ["string", "string"]
            ],
            "city": [
              "string"
            ],
            "pincode": "string",
            "country": [
              "string"
            ],
            "addressLine": "string",
            "postOffice": "string"
          }
        }
      ],
      "directorNames": [
        "string"
      ],
      "principalPlaceAddress": {
        "emailId": "string",
        "address": "string",
        "natureOfBusiness": "string",
        "mobile": "string",
        "lastUpdatedDate": "string",
        "splitAddress": {
          "district": [
            "string"
          ],
          "state": [
            ["string", "string"]
          ],
          "city": [
            "string"
          ],
          "pincode": "string",
          "country": [
            "string"
          ],
          "addressLine": "string",
          "postOffice": "string"
        }
      }
    },
    "gstnRecords": [
      {
        "applicationStatus": "string",
        "registrationName": "string",
        "mobNum": "string",
        "regType": "string",
        "emailId": "string",
        "tinNumber": "string",
        "gstinRefId": "string",
        "gstin": "string"
      }
    ],
    "gstin": "string",
    "annualAggregateTurnOver": "string",
    "aggregateTurnOverRange": {
      "minimum": "number",
      "maximum": "number or null"
    },
    "grossTotalIncome": "string",
    "grossTotalIncomeFinancialYear": "string",
    "filingStatus": [
      {
        "filingYear": "string",
        "monthOfFiling": "string",
        "methodOfFilling": "string",
        "dateOfFiling": "DD/MM/YYYY",
        "gstType": "string",
        "gstStatus": "string"
      }
    ],
    "returnFilingFrequency": [
      {
        "financialYear": "string",
        "returnFilingType": "string",
        "frequency": "string",
        "quarter": "string"
      }
    ]
  },
  "natureOfCoreBusinessActivity": "string",
  "hsnGoods": [
    {
      "hsnCode": "string",
      "description": "string"
    }
  ],
  "hsnServices": [
    {
      "hsnCode": "string",
      "description": "string"
    }
  ]
}

Response Table

Field	Data Type	Description
gstin	String	GST Identification Number
returnFilingFrequency	Boolean	Flag indicating return filing frequency data availability
filingDataForYears	String	Number of years of filing data available
isPostOffice	String	Post office verification flag
id	Number	Unique identifier for the record
result.gstnDetailed.constitutionOfBusiness	String	Business constitution type (e.g., PROPRIETORSHIP)
result.gstnDetailed.legalNameOfBusiness	String	Legal registered name of the business
result.gstnDetailed.tradeNameOfBusiness	String	Trade name under which business operates
result.gstnDetailed.centreJurisdiction	String	Central government jurisdiction details
result.gstnDetailed.stateJurisdiction	String	State government jurisdiction details
result.gstnDetailed.registrationDate	String	GST registration date (YYYY-MM-DD format)
result.gstnDetailed.taxPayerDate	String	Tax payer registration date
result.gstnDetailed.taxPayerType	String	Type of tax payer (e.g., REGULAR)
result.gstnDetailed.gstinStatus	String	Current status of GSTIN (e.g., ACTIVE)
result.gstnDetailed.cancellationDate	String	Date of GST cancellation if applicable
result.gstnDetailed.natureOfBusinessActivities	Array of Strings	List of business activities
result.gstnDetailed.principalPlaceLatitude	String	Latitude of principal place of business
result.gstnDetailed.principalPlaceLongitude	String	Longitude of principal place of business
result.gstnDetailed.principalPlaceStreet	String	Street address of principal place
result.gstnDetailed.principalPlaceLocality	String	Locality of principal place
result.gstnDetailed.principalPlaceCity	String	City of principal place
result.gstnDetailed.principalPlaceDistrict	String	District of principal place
result.gstnDetailed.principalPlaceState	String	State of principal place
result.gstnDetailed.principalPlacePincode	String	PIN code of principal place
result.gstnDetailed.additionalPlaceLatitude	String	Latitude of additional place
result.gstnDetailed.additionalPlaceLongitude	String	Longitude of additional place
result.gstnDetailed.additionalPlaceStreet	String	Street address of additional place
result.gstnDetailed.additionalPlaceLocality	String	Locality of additional place
result.gstnDetailed.additionalPlaceCity	String	City of additional place
result.gstnDetailed.additionalPlaceDistrict	String	District of additional place
result.gstnDetailed.additionalPlaceState	String	State of additional place
result.gstnDetailed.additionalPlacePincode	String	PIN code of additional place
result.gstnDetailed.complianceRating	String	Compliance rating of the taxpayer
result.gstnDetailed.additionalPlaceAddress	Array of Objects	List of additional business addresses
result.gstnDetailed.additionalPlaceAddress[].emailId	String	Email ID for the address
result.gstnDetailed.additionalPlaceAddress[].address	String	Complete formatted address
result.gstnDetailed.additionalPlaceAddress[].natureOfBusiness	String	Nature of business at this address
result.gstnDetailed.additionalPlaceAddress[].mobile	String	Mobile number for the address
result.gstnDetailed.additionalPlaceAddress[].lastUpdatedDate	String	Last update date for the address
result.gstnDetailed.additionalPlaceAddress[].splitAddress.district	Array of Strings	District information
result.gstnDetailed.additionalPlaceAddress[].splitAddress.state	Array of Arrays	State code and name
result.gstnDetailed.additionalPlaceAddress[].splitAddress.city	Array of Strings	City information
result.gstnDetailed.additionalPlaceAddress[].splitAddress.pincode	String	PIN code
result.gstnDetailed.additionalPlaceAddress[].splitAddress.country	Array of Strings	Country codes and name
result.gstnDetailed.additionalPlaceAddress[].splitAddress.addressLine	String	Formatted address line
result.gstnDetailed.additionalPlaceAddress[].splitAddress.postOffice	String	Post office name
result.gstnDetailed.directorNames	Array of Strings	List of director/proprietor names
result.gstnDetailed.principalPlaceAddress.emailId	String	Email ID for principal address
result.gstnDetailed.principalPlaceAddress.address	String	Complete principal address
result.gstnDetailed.principalPlaceAddress.natureOfBusiness	String	Nature of business at principal address
result.gstnDetailed.principalPlaceAddress.mobile	String	Mobile number for principal address
result.gstnDetailed.principalPlaceAddress.lastUpdatedDate	String	Last update date for principal address
result.gstnDetailed.principalPlaceAddress.splitAddress.district	Array of Strings	District information for principal address
result.gstnDetailed.principalPlaceAddress.splitAddress.state	Array of Arrays	State information for principal address
result.gstnDetailed.principalPlaceAddress.splitAddress.city	Array of Strings	City information for principal address
result.gstnDetailed.principalPlaceAddress.splitAddress.pincode	String	PIN code for principal address
result.gstnDetailed.principalPlaceAddress.splitAddress.country	Array of Strings	Country information for principal address
result.gstnDetailed.principalPlaceAddress.splitAddress.addressLine	String	Formatted address line for principal address
result.gstnDetailed.principalPlaceAddress.splitAddress.postOffice	String	Post office name for principal address
result.gstnRecords	Array of Objects	GST registration records
result.gstnRecords[].applicationStatus	String	Application status
result.gstnRecords[].registrationName	String	Registration name
result.gstnRecords[].mobNum	String	Mobile number
result.gstnRecords[].regType	String	Registration type
result.gstnRecords[].emailId	String	Email ID
result.gstnRecords[].tinNumber	String	TIN number
result.gstnRecords[].gstinRefId	String	GSTIN reference ID
result.gstnRecords[].gstin	String	GSTIN number
result.gstin	String	GSTIN number (duplicate field)
result.annualAggregateTurnOver	String	Annual aggregate turnover slab
result.aggregateTurnOverRange.minimum	Number	Minimum turnover range value
result.aggregateTurnOverRange.maximum	Number	Maximum turnover range value
result.grossTotalIncome	String	Gross total income
result.grossTotalIncomeFinancialYear	String	Financial year for gross total income
result.filingStatus	Array of Objects	GST return filing status records
result.filingStatus[].filingYear	String	Financial year of filing
result.filingStatus[].monthOfFiling	String	Month of filing
result.filingStatus[].methodOfFilling	String	Method of filing (ONLINE/OFFLINE)
result.filingStatus[].dateOfFiling	String	Date of filing (DD/MM/YYYY format)
result.filingStatus[].gstType	String	Type of GST return (GSTR1, GSTR3B, etc.)
result.filingStatus[].gstStatus	String	Filing status (Filed, Pending, etc.)
result.returnFilingFrequency	Array of Objects	Return filing frequency information
result.returnFilingFrequency[].financialYear	String	Financial year
result.returnFilingFrequency[].returnFilingType	String	Type of return (GSTR1, GSTR3B, etc.)
result.returnFilingFrequency[].frequency	String	Filing frequency (Monthly, Quarterly, etc.)
result.returnFilingFrequency[].quarter	String	Quarter period (Apr-Jun, etc.)
natureOfCoreBusinessActivity	String	Core business activity description
hsnGoods	Array of Objects	HSN codes for goods
hsnGoods[].hsnCode	String	HSN code for goods
hsnGoods[].description	String	Description of goods
hsnServices	Array of Objects	HSN codes for services
hsnServices[].hsnCode	String	HSN code for services
hsnServices[].description	String	Description of services

Error Response

HTTP Status Code	Error Type	Description
400	Bad Request	Invalid GSTIN or missing parameters
401	Unauthorized	Unauthorized access
409	Upstream Down	Issue is fetching the details
404	Not Found	GSTIN not found