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 |