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