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/submitOtpPOST https://api-preproduction.signzy.app/api/v3/detailed-gst/submitOtpRequest 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!