GST Detail Fetch
Introduction
GSTIN Details Fetch API is an advanced and efficient solution designed for businesses, tax professionals, and financial analysts. This API is engineered to provide comprehensive details associated with a given GSTIN (Goods and Services Tax Identification Number), which is a unique ID for businesses registered under the GST regime in India.
Input a GSTIN number and receive a detailed report about the corresponding business entity. You can access a wide array of information including legal and trade names, business constitution, jurisdiction details, registration date, taxpayer type, GSTIN status, filing status, and filing frequency on request.
API Details
URLs
Sandbox URL | https://api-preproduction.signzy.app/api/v3/banking/gstnDetailed |
|---|---|
Production URL | https://api.signzy.app/api/v3/banking/gstnDetailed |
Request BodyÂ
'{
"gstin": "20AGRPG2101P1ZL",
"returnFilingFrequency": "true",
"filingDataForYears": 1
}'CURL
curl --location 'https://api.signzy.app/api/v3/banking/gstnDetailed' \
--header 'Authorization: ******' \
--header 'Content-Type: application/json' \
--data '{
"gstin": "27EZCPR7147N1ZK"
}
'Parameter | Type | Required | Description |
|---|---|---|---|
gstin | string | Yes | 15 digit gstin number |
returnFilingFrequency | string | Optional | Boolean param for getting filling frequency |
filingDataForYears | string | optional | Integer value to poll filling data for given number of years |

Response Structure
{
"gstin": "27EZCPR7147N1ZK",
"result": {
"gstnDetailed": {
"constitutionOfBusiness": "PROPRIETORSHIP",
"legalNameOfBusiness": "GOKAL RAM",
"tradeNameOfBusiness": "NEW BALAJI TRADERS",
"centreJurisdiction": "STATE - CBIC,ZONE - PUNE,COMMISSIONERATE - PUNE - II,DIVISION - DIVISION-VII KATRAJ,RANGE - RANGE-II (JURISDICTIONAL OFFICE)",
"stateJurisdiction": "STATE - MAHARASHTRA,ZONE - PUNE_SOUTH_WEST,DIVISION - PUNE_SOUTH,CHARGE - PUNE CANTT_701",
"registrationDate": "2021-03-09",
"taxPayerDate": "",
"taxPayerType": "REGULAR",
"gstinStatus": "ACTIVE",
"cancellationDate": "",
"natureOfBusinessActivities": [
"SUPPLIER OF SERVICES",
"RETAIL BUSINESS",
"WHOLESALE BUSINESS"
],
"additionalTradeName": [
"SHREE NAKHATESH TRADERS WHOLESALE",
"NEW BALAJI TRADER",
"SHREE BALAJI TRADERS WHOLESALE"
],
"principalPlaceLatitude": "",
"principalPlaceLongitude": "",
"principalPlaceStreet": "",
"principalPlaceLocality": "",
"principalPlaceCity": "",
"principalPlaceDistrict": "",
"principalPlaceState": "",
"principalPlacePincode": "",
"additionalPlaceLatitude": "",
"additionalPlaceLongitude": "",
"additionalPlaceStreet": "",
"additionalPlaceLocality": "",
"additionalPlaceCity": "",
"additionalPlaceDistrict": "",
"additionalPlaceState": "",
"additionalPlacePincode": "",
"complianceRating": "",
"additionalPlaceAddress": [
{
"address": "Ground Floor, Shop no. 1, Chaudhari Shop, Ganesh Nagar, S.no. 10, Near Vijay Medical, Yerwada, Pune, Pune, Maharashtra, 411006",
"natureOfBusiness": "RETAIL BUSINESS",
"lastUpdatedDate": "",
"splitAddress": {
"district": [
"PUNE"
],
"state": [
[
"MAHARASHTRA",
"MH"
]
],
"city": [
"PUNE CITY"
],
"pincode": "411006",
"country": [
"IN",
"IND",
"INDIA"
],
"addressLine": "GROUND FLOOR,SHOP NO.1,CHAUDHARI SHOP,GANESH NAGAR,S.NO.10,NEAR VIJAY MEDICAL,YERWADA,PUNE"
}
}
],
"principalPlaceAddress": {
"address": "GR FLOOR, S NO 13/1 SHOP NO 01, DHANMAI CORNER, SUKHSAGAR NAGAR KATRAJ, PUNE, Pune, Maharashtra, 411046",
"natureOfBusiness": "SUPPLIER OF SERVICES, RETAIL BUSINESS",
"lastUpdatedDate": "",
"splitAddress": {
"district": [
"PUNE"
],
"state": [
[
"MAHARASHTRA",
"MH"
]
],
"city": [
"PUNE CITY"
],
"pincode": "411046",
"country": [
"IN",
"IND",
"INDIA"
],
"addressLine": "GR FLOOR,S NO 13/1 SHOP NO 01,DHANMAI CORNER,SUKHSAGAR NAGAR KATRAJ,PUNE"
}
}
},
"gstnRecords": [
{
"applicationStatus": "",
"registrationName": "GOKAL RAM",
"regType": "",
"tinNumber": "",
"gstinRefId": "",
"gstin": "27EZCPR7147N1ZK"
}
],
"gstin": "27EZCPR7147N1ZK",
"annualAggregateTurnOver": "Slab: Rs. 5 Cr. to 25 Cr.",
"aggregateTurnOverRange": {
"minimum": 50000000,
"maximum": 250000000
},
"grossTotalIncome": "Up to Rs. 2.5 lakhs",
"grossTotalIncomeFinancialYear": "",
"filingStatus": [
{
"filingYear": "2024-2025",
"monthOfFiling": "March",
"methodOfFilling": "ONLINE",
"dateOfFiling": "25/04/2025",
"gstType": "GSTR1",
"gstStatus": "Filed"
}
],
"returnFilingFrequency": [
{
"financialYear": "2025-2026",
"returnFilingType": "GSTR1",
"frequency": "Quarterly",
"quarter": "Apr-Jun"
},
{
"financialYear": "2025-2026",
"returnFilingType": "GSTR1",
"frequency": "Quarterly",
"quarter": "Jul-Sep"
}
]
}
}Response Parameter
Field | Data type | Description |
|---|---|---|
gstin | string | GSTIN queried in the request. |
result | object | Container object holding the consolidated GST profile. |
result.gstnDetailed | object | GST registration master profile object. |
result.gstnDetailed.constitutionOfBusiness | string | Constitution of business (e.g., PROPRIETORSHIP). |
result.gstnDetailed.legalNameOfBusiness | string | Legal registered business name. |
result.gstnDetailed.tradeNameOfBusiness | string | Primary trade name of the business. |
result.gstnDetailed.centreJurisdiction | string | CBIC centre jurisdiction hierarchy. |
result.gstnDetailed.stateJurisdiction | string | State GST jurisdiction hierarchy. |
result.gstnDetailed.registrationDate | string | GST registration date (YYYY-MM-DD). |
result.gstnDetailed.taxPayerDate | string | Taxpayer lifecycle date (if available). |
result.gstnDetailed.taxPayerType | string | Taxpayer category (e.g., REGULAR). |
result.gstnDetailed.gstinStatus | string | Current GSTIN status (ACTIVE/CANCELLED/etc.). |
result.gstnDetailed.cancellationDate | string | GST cancellation date, if cancelled. |
result.gstnDetailed.natureOfBusinessActivities | array | List of business activity types (retail, wholesale, services). |
result.gstnDetailed.additionalTradeName | array | Additional trade names. |
result.gstnDetailed.principalPlaceLatitude | string | Latitude of principal place (if available). |
result.gstnDetailed.principalPlaceLongitude | string | Longitude of principal place (if available). |
result.gstnDetailed.principalPlaceStreet | string | Street component of principal address. |
result.gstnDetailed.principalPlaceLocality | string | Locality component of principal address. |
result.gstnDetailed.principalPlaceCity | string | City component of principal address. |
result.gstnDetailed.principalPlaceDistrict | string | District component of principal address. |
result.gstnDetailed.principalPlaceState | string | State component of principal address. |
result.gstnDetailed.principalPlacePincode | string | Pincode of principal address. |
result.gstnDetailed.additionalPlaceLatitude | string | Latitude of additional place (if available). |
result.gstnDetailed.additionalPlaceLongitude | string | Longitude of additional place (if available). |
result.gstnDetailed.additionalPlaceStreet | string | Street component of additional place. |
result.gstnDetailed.additionalPlaceLocality | string | Locality component of additional place. |
result.gstnDetailed.additionalPlaceCity | string | City component of additional place. |
result.gstnDetailed.additionalPlaceDistrict | string | District component of additional place. |
result.gstnDetailed.additionalPlaceState | string | State component of additional place. |
result.gstnDetailed.additionalPlacePincode | string | Pincode of additional place. |
result.gstnDetailed.complianceRating | string | Compliance rating indicator (if available). |
result.gstnDetailed.principalPlaceAddress | object | Structured principal place address object. |
result.gstnDetailed.principalPlaceAddress.address | string | Full formatted principal address. |
result.gstnDetailed.principalPlaceAddress.natureOfBusiness | string | Nature of business at principal location. |
result.gstnDetailed.principalPlaceAddress.lastUpdatedDate | string | Last updated date of principal address. |
result.gstnDetailed.principalPlaceAddress.splitAddress | object | Normalized address components for principal address. |
result.gstnDetailed.principalPlaceAddress.splitAddress.district | array | District values parsed from address. |
result.gstnDetailed.principalPlaceAddress.splitAddress.state | array | State name and code pairs. |
result.gstnDetailed.principalPlaceAddress.splitAddress.city | array | City values parsed from address. |
result.gstnDetailed.principalPlaceAddress.splitAddress.pincode | string | Parsed pincode. |
result.gstnDetailed.principalPlaceAddress.splitAddress.country | array | Country codes and name. |
result.gstnDetailed.principalPlaceAddress.splitAddress.addressLine | string | Normalized single-line address. |
result.gstnDetailed.additionalPlaceAddress | array | List of additional business location objects. |
result.gstnDetailed.additionalPlaceAddress[].address | string | Full formatted additional place address. |
result.gstnDetailed.additionalPlaceAddress[].natureOfBusiness | string | Nature of business at additional location. |
result.gstnDetailed.additionalPlaceAddress[].lastUpdatedDate | string | Last updated date of additional location. |
result.gstnDetailed.additionalPlaceAddress[].splitAddress | object | Normalized address components for additional location. |
result.gstnDetailed.additionalPlaceAddress[].splitAddress.district | array | District values parsed from address. |
result.gstnDetailed.additionalPlaceAddress[].splitAddress.state | array | State name and code pairs. |
result.gstnDetailed.additionalPlaceAddress[].splitAddress.city | array | City values parsed from address. |
result.gstnDetailed.additionalPlaceAddress[].splitAddress.pincode | string | Parsed pincode. |
result.gstnDetailed.additionalPlaceAddress[].splitAddress.country | array | Country codes and names. |
result.gstnDetailed.additionalPlaceAddress[].splitAddress.addressLine | string | Normalized single-line address. |
result.gstnRecords | array | List of GST registration record objects. |
result.gstnRecords[].applicationStatus | string | GST registration application status. |
result.gstnRecords[].registrationName | string | Registration name on GST. |
result.gstnRecords[].regType | string | Registration type. |
result.gstnRecords[].tinNumber | string | TIN number if mapped. |
result.gstnRecords[].gstinRefId | string | Reference ID for GSTIN. |
result.gstnRecords[].gstin | string | GSTIN value. |
result.gstin | string | GSTIN echoed in result object. |
result.annualAggregateTurnOver | string | Annual aggregate turnover slab label. |
result.aggregateTurnOverRange | object | Numeric turnover range object. |
result.aggregateTurnOverRange.minimum | number | Minimum turnover in INR. |
result.aggregateTurnOverRange.maximum | number | Maximum turnover in INR. |
result.grossTotalIncome | string | Gross total income slab label. |
result.grossTotalIncomeFinancialYear | string | Financial year for GTI data. |
result.filingStatus | array | Historical GST return filing events. |
result.filingStatus[].filingYear | string | Financial year of filing. |
result.filingStatus[].monthOfFiling | string | Filing period (month or annual). |
result.filingStatus[].methodOfFilling | string | Filing method (ONLINE/OFFLINE). |
result.filingStatus[].dateOfFiling | string | Date when return was filed. |
result.filingStatus[].gstType | string | Return type (GSTR1, GSTR3B, GSTR9, GSTR9C). |
result.filingStatus[].gstStatus | string | Filing status (Filed/Not Filed). |
result.returnFilingFrequency | array | Return filing frequency mapping. |
result.returnFilingFrequency[].financialYear | string | Financial year for frequency record. |
result.returnFilingFrequency[].returnFilingType | string | Return type (GSTR1, GSTR3B, GSTR9, GSTR9C). |
result.returnFilingFrequency[].frequency | string | Filing frequency |
result.returnFilingFrequency[].quarter | string | Quarter label (Apr-Jun, Jul-Sep, etc.). |

Error Code Table
{
"error": {
"reason": "Error From Upstream",
"status": 409,
"message": "Upstream Down",
"type": "Conflict",
"statusCode": 409,
"name": "error"
}
}Error Responses
HTTP | Error |
|---|---|
400 | Validation error |
404 | GST not Found |
409 | Conflict |
Error Handling
Scenario | Recommended action |
|---|---|
400 Validation error | Log the error message for debugging. Do not retry fix the request payload first. |
404 Request ID not found | Re-submit Step 1 to get a fresh requestId. Ensure Step 2 is called within 10 minutes of Step 1. |
404 GSTIN not found | The PAN may not have GST registrations |
409 Upstream | Retry Request |