Gst detailed-Submit OTP API

Introduction

The GSTIN Detailed Search with OTP API introduces an additional layer of security through an OTP (One-Time Password) verification process.

When a user inputs a GSTIN number, an OTP is triggered and sent to the mobile number registered with the GST system. The user must enter this OTP to verify their access before retrieving the detailed report about the corresponding business entity. Once verified, 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/detailed-gst/submitOtp

POST https://api-preproduction.signzy.app/api/v3/detailed-gst/submitOtp

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
requestId	String	RequestId is required to map a Generate OTP request with submit OTP request	Mandatory
otp	String	OTP sent to registered mobile number	Mandatory

{
    "requestId": "dwPIXE95qP18PqHUcYXP",
    "otp": "103848"
}

curl --location 'https://api-preproduction.signzy.app/api/v3/detailed-gst/submitOtp' \
--header 'Content-Type: application/json' \
--header 'Authorization: <Auth Token>' \
--data '{
    "requestId": "dwPIXE95qP18PqHUcYXP",
    "otp": "103848"
}'

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.

{
    "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": [],
            "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"
            }
        ]
    }
}

Contact Us for Any Assistance

If you have any questions or need assistance, please reach out to our customer support team. You can contact us via email at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.

We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!