GSTIN Detailed Search

Introduction

GSTIN Detailed Search 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

Endpoint

POST https://api.signzy.app/api/v3/gstn/gstndetailed

POST https://api-preproduction.signzy.app/api/v3/gstn/gstndetailed

Request headers

Name	Value	Required	Description
Content-Type	application/json	Mandatory	The type of content that the request body contains.
Authorization	XXXXXXXXXXXXXXX	Mandatory	An authentication token to authorize the request. Reach out to the Signzy support team to get one created.

Request body parameters

Parameter	Data Type	Description	Required
gstin	String	The GST identification number. UIN number is also supported.	Mandatory
returnFilingFrequency	Boolean	Indicates whether to return filing frequency or not. true/false.	Optional
getAllAdditionalAddress	string	Indicaters whether to return all additional addresses or not	optional

{
    "gstin": "<GSTIN>",
    "returnFilingFrequency": true,
    "getAllAdditionalAddress": "true"
}

Code samples

curl --location 'https://api-preproduction.signzy.app/api/v3/gstn/gstndetailed' \
--header 'Content-Type: application/json' \
--header 'Authorization: <Your access token>' \
--data '{
    "gstin": "<GSTIN>",
    "returnFilingFrequency": true,
    "getAllAdditionalAddress": "true"
}'

Response body parameters

Parameter	Data Type	Description
gstin	String	GSTIN of the entity.
returnFilingFrequency	Boolean	Indicates whether to return filing frequency data.
id	Integer	Unique ID for the request.
result	Object	Contains the result of the task.
result.gstnDetailed	Object	Details about the GSTIndentifer Number.
result.gstnDetailed.constitutionOfBusiness	String	Type of business constitution. (Proprietorship; Partnership; Hindu Undivided Family; Private Limited Company; Public Limited Company; Society/ Club/ Trust/ AOP; Government Department; Public Sector Undertaking; Unlimited Company; Limited Liability Partnership; Local Authority; Statutory Body; Foreign Company; Foreign Limited Liability Partnership; Others
result.gstnDetailed.legalNameOfBusiness	String	Legal name of the business.
result.gstnDetailed.tradeNameOfBusiness	String	Trade name of the business.
result.gstnDetailed.centreJurisdiction	String	Central jurisdiction details of the business.
result.gstnDetailed.stateJurisdiction	String	State jurisdiction details of the business.
result.gstnDetailed.registrationDate	String	Date of GST registration. In the format YYYY-MM-DD.
result.gstnDetailed.taxPayerDate	String	Last date to pay tax.
result.gstnDetailed.taxPayerType	String	Type of taxpayer. The possible values are: REGULAR COMPOSITE EXEMPTED
result.gstnDetailed.gstinStatus	String	Status of GSTIN. The possible values are: "ACTIVE" "CANCELLED" "PROVISIONAL" "gstinStatus": "PENDING REGULAR REGISTRATION" "gstinStatus": "INACTIVE" "gstinStatus": "ACTIVE PENDING VERIFICATION" "gstinStatus": "CANCELLED ON APPLICATION OF TAXPAYER" "gstinStatus": "CANCELLED SUO-MOTO" "gstinStatus": "SUSPENDED
result.gstnDetailed.cancellationDate	String	Date of GSTIN cancellation.
result.gstnDetailed.natureOfBusinessActivities	Array of strings	List of business activities.
result.gstnDetailed.principalPlaceLatitude	String	Latitude of the principal place of business.
result.gstnDetailed.principalPlaceLongitude	String	Longitude of the principal place of business.
result.gstnDetailed.principalPlaceStreet	String	Street of the principal place of business.
result.gstnDetailed.principalPlaceLocality	String	Locality of the principal place of business.
result.gstnDetailed.principalPlaceCity	String	City of the principal place of business.
result.gstnDetailed.principalPlaceDistrict	String	District of the principal place of business.
result.gstnDetailed.principalPlaceState	String	State of the principal place of business.
result.gstnDetailed.principalPlacePincode	String	Pincode of the principal place of business.
result.gstnDetailed.additionalPlaceLatitude	String	Latitude of the additional place of business.
result.gstnDetailed.additionalPlaceLongitude	String	Longitude of the additional place of business.
result.gstnDetailed.additionalPlaceStreet	String	Street of the additional place of business.
result.gstnDetailed.additionalPlaceLocality	String	Locality of the additional place of business.
result.gstnDetailed.additionalPlaceCity	String	City of the additional place of business.
result.gstnDetailed.additionalPlaceDistrict	String	District of the additional place of business.
result.gstnDetailed.additionalPlaceState	String	State of the additional place of business.
result.gstnDetailed.additionalPlacePincode	String	Pincode of the additional place of business.
result.gstnDetailed.complianceRating	String	GST compliance rating.
result.gstnDetailed.additionalPlaceAddress	Array of objects	Addresses of additional places of business.
result.gstnDetailed.directorNames	Array of strings	Names of the directors.
result.gstnDetailed.principalPlaceAddress	Object	Detailed address of the principal place of business.
result.gstnDetailed.principalPlaceAddress.emailId	String	Email ID associated with the principal place of business.
result.gstnDetailed.principalPlaceAddress.address	String	Address of the principal place of business.
result.gstnDetailed.principalPlaceAddress.natureOfBusiness	String	Nature of business activities at the principal place.
result.gstnDetailed.principalPlaceAddress.mobile	String	Mobile number associated with the principal place of business.
result.gstnDetailed.principalPlaceAddress.lastUpdatedDate	String	Last updated date of the principal place of business address.
result.gstnDetailed.principalPlaceAddress.splitAddress	Object	Contains principal place address in split format.
result.gstnDetailed.principalPlaceAddress.splitAddress.district	Array	District.
result.gstnDetailed.principalPlaceAddress.splitAddress.state	Array	State.
result.gstnDetailed.principalPlaceAddress.splitAddress.city	Array	City.
result.gstnDetailed.principalPlaceAddress.splitAddress.pincode	String	Pincode.
result.gstnDetailed.principalPlaceAddress.splitAddress.country	Array	Country.
result.gstnDetailed.principalPlaceAddress.splitAddress.addressLine	String	Address line.
result.gstnRecords	Array of object	GSTIN records.
result.gstnRecords.applicationStatus	String	Application status in each GSTIN record.
result.gstnRecords.registrationName	String	Registration name in each GSTIN record.
result.gstnRecords.mobNum	String	Mobile number.
result.gstnRecords.regType	String	Registration type in each GSTIN record.
result.gstnRecords.emailId	String	Email ID.
result.gstnRecords.tinNumber	String	TIN number.
result.gstnRecords.gstinRefId	String	GSTIN reference ID in each GSTIN record.
result.gstnRecords.gstin	String	GSTIN in each GSTIN record.
result.annualAggregateTurnOver	String	Aggregate turnover range. (This number corresponds to last financial year for which all quarterly returns were filed)
result.aggregateTurnOverRange	Object	Contains aggregate turnover range.
result.aggregateTurnOverRange.minimum	Integer	Minimum value of the turnover range.
result.aggregateTurnOverRange.maximum	Integer	Maximum value of the turnover range.
result.grossTotalIncome	String	Gross total income.
result.grossTotalIncomeFinancialYear	String	Financial year of the gross total income.
result.filingStatus	Array of objects	Filing status records for all financial years.
result.filingStatus.filingYear	String	Financial year of the filing record.
result.filingStatus.monthOfFiling	String	Month of filing for the record.
result.filingStatus.methodOfFilling	String	Method of filing for the record.
result.filingStatus.dateOfFiling	String	Date of filing for the record. In format DD/MM/YYYY.
result.filingStatus.gstType	String	GST type for the filing record.
result.filingStatus.gstStatus	String	GST status for the filing record.
result.returnFilingFrequency	Array of objects	Filing frequency details. This is available only when “returnFilingFrequency” is true.
result.returnFilingFrequency.financialYear	String	Financial year.
result.returnFilingFrequency.returnFilingType	String	GSTIN filing type.
result.returnFilingFrequency.frequency	String	Frequency of filing. The possible values are: Monthly Quarterly
result.returnFilingFrequency.quarter	String	Quarter for the return filing frequency.

{
    "gstin": "<GSTIN>",
    "returnFilingFrequency": true,
    "id": 52,
    "result": {
        "gstnDetailed": {
            "constitutionOfBusiness": "PUBLIC LIMITED COMPANY",
            "legalNameOfBusiness": "LEGAL NAME",
            "tradeNameOfBusiness": "TRADE NAME",
            "centreJurisdiction": "COMMISSIONERATE - PUNE - I,DIVISION - DIVISION-II PIMPRI,RANGE - RANGE-V (JURISDICTIONAL OFFICE)",
            "stateJurisdiction": "STATE - MAHARASHTRA,ZONE - PUNE,DIVISION - PUNE-LTU-2,CHARGE - PUNE_LTU_524",
            "registrationDate": "2017-07-01",
            "taxPayerDate": "",
            "taxPayerType": "REGULAR",
            "gstinStatus": "ACTIVE",
            "cancellationDate": "",
            "natureOfBusinessActivities": [
                "FACTORY / MANUFACTURING",
                "INPUT SERVICE DISTRIBUTOR (ISD)",
                "OFFICE / SALE OFFICE",
                "RETAIL BUSINESS",
                "SERVICE PROVISION",
                "RECIPIENT OF GOODS OR SERVICES",
                "WORKS CONTRACT",
                "WHOLESALE BUSINESS",
                "WAREHOUSE / DEPOT",
                "BONDED WAREHOUSE"
            ],
            "principalPlaceLatitude": "",
            "principalPlaceLongitude": "",
            "principalPlaceStreet": "",
            "principalPlaceLocality": "",
            "principalPlaceCity": "",
            "principalPlaceDistrict": "",
            "principalPlaceState": "",
            "principalPlacePincode": "",
            "additionalPlaceLatitude": "",
            "additionalPlaceLongitude": "",
            "additionalPlaceStreet": "",
            "additionalPlaceLocality": "",
            "additionalPlaceCity": "",
            "additionalPlaceDistrict": "",
            "additionalPlaceState": "",
            "additionalPlacePincode": "",
            "complianceRating": "",
            "additionalPlaceAddress": [
                            {
                    "emailId": "",
                    "address": "",
                    "natureOfBusiness": "",
                    "mobile": "",
                    "lastUpdatedDate": "",
                    "splitAddress": {
                        "district": [
                            "MUMBAI SUBURBAN"
                        ],
                        "state": [
                            [
                                "MAHARASHTRA",
                                "MH"
                            ]
                        ],
                        "city": [
                            "MUMBAI"
                        ],
                        "pincode": "400093",
                        "country": [
                            "IN",
                            "IND",
                            "INDIA"
                        ],
                        "addressLine": ""
                    }
                }
            ],
            "directorNames": [
                "Name 1",
                "Name 2"
            ],
            "principalPlaceAddress": {
                "emailId": "[email protected]",
                "address": "ADDRESS",
                "natureOfBusiness": "FACTORY / MANUFACTURING, INPUT SERVICE DISTRIBUTOR (ISD), OFFICE / SALE OFFICE, RETAIL BUSINESS, SERVICE PROVISION, RECIPIENT OF GOODS OR SERVICES, WORKS CONTRACT, WHOLESALE BUSINESS, WAREHOUSE / DEPOT, BONDED WAREHOUSE",
                "mobile": "0000000000",
                "lastUpdatedDate": "",
                "splitAddress": {
                    "district": [
                        "PUNE"
                    ],
                    "state": [
                        [
                            "MAHARASHTRA",
                            "MH"
                        ]
                    ],
                    "city": [
                        "PUNE CITY"
                    ],
                    "pincode": "411018",
                    "country": [
                        "IN",
                        "IND",
                        "INDIA"
                    ],
                    "addressLine": "ADDRESS LINE"
                }
            }
        },
        "gstnRecords": [
            {
                "applicationStatus": "",
                "registrationName": "NAME",
                "mobNum": "",
                "regType": "",
                "emailId": "",
                "tinNumber": "",
                "gstinRefId": "",
                "gstin": "<GSTIN>"
            }
        ],
        "gstin": "<GSTIN>",
        "annualAggregateTurnOver": "Slab: Rs. 500 Cr. and above",
        "aggregateTurnOverRange": {
            "minimum": 5000000000,
            "maximum": null
        },
        "grossTotalIncome": "",
        "grossTotalIncomeFinancialYear": "",
        "filingStatus": [
            {
                "filingYear": "2023-2024",
                "monthOfFiling": "November",
                "methodOfFilling": "GSP",
                "dateOfFiling": "21/11/2023",
                "gstType": "GSTR1",
                "gstStatus": "Not Filed"
            }
        ],
        "returnFilingFrequency": [
            {
                "financialYear": "2023-2024",
                "returnFilingType": "GSTR1",
                "frequency": "Monthly",
                "quarter": "Apr-Jun"
            }
        ]
    }
}

Description of gstinStatus

ACTIVE: The GSTIN is currently valid and the taxpayer is authorized to conduct business under the GST regime.

CANCELLED: The GST registration has been terminated, either by the taxpayer or by tax authorities, and the taxpayer is no longer permitted to operate under GST.

PROVISIONAL: A temporary status assigned during the migration to GST or initial registration, indicating that the registration is not yet finalized.

PENDING REGULAR REGISTRATION: The application for GST registration has been submitted and is under review by tax authorities; final approval is awaited.

INACTIVE: The GSTIN is not currently active, possibly due to non-compliance or other issues, and the taxpayer cannot legally conduct business under GST.

ACTIVE PENDING VERIFICATION: The GSTIN is active, but certain details or documents are pending verification by tax authorities.

CANCELLED ON APPLICATION OF TAXPAYER: The GST registration has been cancelled at the request of the taxpayer.

CANCELLED SUO-MOTO: The GST registration has been cancelled by tax authorities on their own initiative, often due to non-compliance or other regulatory reasons.

SUSPENDED: The GSTIN is temporarily inactive, and the taxpayer is not allowed to conduct business under GST during the suspension period.

FAQs

Getting help Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better. You can reach out to us at [email protected].