Search by GSTIN
Introduction
The "Search by GSTIN" API is a powerful tool for retrieving detailed information associated with a specific GSTIN (Goods and Services Tax Identification Number). Ideal for businesses and tax professionals, this API allows users to input a GSTIN and receive comprehensive data, including business constitution, legal and trade names, jurisdiction details, registration dates, taxpayer type, and GSTIN status. Moreover, it provides precise location details of the principal and additional business places. This API is invaluable for verifying GSTIN-related information, ensuring compliance, and facilitating smooth business operations by providing essential data at your fingertips.
API details
Endpoint
https://api.signzy.app/api/v3/gst/searchPOST https://api-preproduction.signzy.app/api/v3/gst/searchRequest 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 | GSTIN (Goods and Services Tax Identification Number) of the user or company. UIN is not supported. | Mandatory |
consent | String | User's consent | Optional |
{
"gstin": "<gstin Number>",
"consent":"Y/N"
}curl --location 'https://api-preproduction.signzy.app/api/v3/gst/search' \
--header 'Content-Type: application/json' \
--header 'Authorization: <Auth Token>' \
--data '{
"gstin": "<gstin Number>",
"consent":"Y/N"
}'Response body parameters
Parameter | Data Type | Description |
|---|---|---|
result | Object | The main container for the GST (Goods and Services Tax) information. |
result.gstnDetailed | Object | Detailed information about the GST registration for the business. |
result.gstnDetailed.constitutionOfBusiness | String | The legal structure or constitution of the business, in this case, "PRIVATE LIMITED COMPANY." |
result.gstnDetailed.legalNameOfBusiness | String | The legal name of the business, which is "SIGNZY TECHNOLOGIES PRIVATE LIMITED." |
result.gstnDetailed.tradeNameOfBusiness | String | The trade name of the business, which is also "SIGNZY TECHNOLOGIES PRIVATE LIMITED." |
result.gstnDetailed.centreJurisdiction | String | The jurisdiction center for the business, specified as "RANGE-IV." |
result.gstnDetailed.stateJurisdiction | String | The state jurisdiction for the business, specified as "DECCAN-GYMKHANA_501." |
result.gstnDetailed.registrationDate | String | The date when the business was registered for GST, in the format "DD/MM/YYYY," e.g., "01/07/2017." |
result.gstnDetailed.taxPayerDate | String | The date when the business became a taxpayer, if available. |
result.gstnDetailed.taxPayerType | String | The type of taxpayer, in this case, "REGULAR." |
result.gstnDetailed.gstinStatus | String | The GSTIN (Goods and Services Tax Identification Number) status, in this case, "ACTIVE." |
result.gstnDetailed.cancellationDate | String | The date when the GST registration was canceled, if applicable. |
result.gstnDetailed.e-invoicingStatus | String | Indicates whether e-invoicing is applicable for the business, in this case, "YES." |
result.gstnDetailed.natureOfBusinessActivities | Array | An array specifying the nature of business activities, in this case, ["SERVICE PROVISION", "SUPPLIER OF SERVICES"]. |
result.gstnDetailed.principalPlaceAddress | String | The principal place of business address, including street, locality, city, state, and pincode. |
result.gstnDetailed.principalPlaceLatitude | String | The latitude of the principal place of business, if available. |
result.gstnDetailed.principalPlaceLongitude | String | The longitude of the principal place of business, if available. |
result.gstnDetailed.principalPlaceBuildingNameFromGST | String | The building name from GST for the principal place of business, in this case, "SOC 131 2." |
result.gstnDetailed.principalPlaceBuildingNoFromGST | String | The building number from GST for the principal place of business, in this case, "18 B, KUBERA BAHAR BUNGLOWS." |
result.gstnDetailed.principalPlaceFlatNo | String | The flat or unit number for the principal place of business, in this case, "BANER PASHAN LINK ROAD." |
result.gstnDetailed.principalPlaceStreet | String | The street name for the principal place of business, in this case, "PUNE." |
result.gstnDetailed.principalPlaceLocality | String | The locality for the principal place of business, in this case, "PUNE." |
result.gstnDetailed.principalPlaceCity | String | The city for the principal place of business. |
result.gstnDetailed.principalPlaceDistrict | String | The district for the principal place of business, in this case, "PUNE." |
result.gstnDetailed.principalPlaceState | String | The state for the principal place of business, in this case, "MAHARASHTRA." |
result.gstnDetailed.principalPlacePincode | String | The pincode for the principal place of business, in this case, "411021." |
result.gstnDetailed.additionalPlaceAddress | String | Additional place of business address, if applicable. |
result.gstnDetailed.additionalPlaceLatitude | String | The latitude of the additional place of business, if available. |
result.gstnDetailed.additionalPlaceLongitude | String | The longitude of the additional place of business, if available. |
result.gstnDetailed.additionalPlaceBuildingNameFromGST | String | The building name from GST for the additional place of business, in this case, "Tower 1, One international centre." |
result.gstnDetailed.additionalPlaceBuildingNoFromGST | String | The building number from GST for the additional place of business, in this case, "Unit 801-802." |
result.gstnDetailed.additionalPlaceFlatNo | String | The flat or unit number for the additional place of business, in this case, "8th Floor." |
result.gstnDetailed.additionalPlaceStreet | String | The street name for the additional place of business, in this case, "Senapati Bapat Marg." |
result.gstnDetailed.additionalPlaceLocality | String | The locality for the additional place of business, in this case, "Mumbai." |
result.gstnDetailed.additionalPlaceCity | String | The city for the additional place of business. |
result.gstnDetailed.additionalPlaceDistrict | String | The district for the additional place of business, in this case, "Mumbai." |
result.gstnDetailed.additionalPlaceState | String | The state for the additional place of business, in this case, "Maharashtra." |
result.gstnDetailed.additionalPlacePincode | String | The pincode for the additional place of business, in this case, "400013." |
result.gstnDetailed.additionalAddressArray | Array | An array containing additional addresses, if applicable. |
result.gstnDetailed.additionalAddressArray[0].address | String | The additional address, in this case, "8TH FLOOR, UNIT 801-802, SENAPATI BAPAT MARG, MUMBAI, MAHARASHTRA, 400013." |
result.gstnDetailed.additionalAddressArray[0].flatNo | String | The flat or unit number for the additional address, in this case, "8th Floor." |
result.gstnDetailed.additionalAddressArray[0].street | String | The street name for the additional address, in this case, "Senapati Bapat Marg." |
result.gstnDetailed.additionalAddressArray[0].locality | String | The locality for the additional address, in |
this case, "Mumbai." | ||
result.gstnDetailed.additionalAddressArray[0].buildingNo | String | The building number for the additional address, in this case, "Unit 801-802." |
result.gstnDetailed.additionalAddressArray[0].buildingName | String | The building name for the additional address, in this case, "Tower 1, One international centre." |
result.gstnDetailed.additionalAddressArray[0].district | String | The district for the additional address, in this case, "Mumbai." |
result.gstnDetailed.additionalAddressArray[0].city | String | The city for the additional address. |
result.gstnDetailed.additionalAddressArray[0].state | String | The state for the additional address, in this case, "Maharashtra." |
result.gstnDetailed.additionalAddressArray[0].pincode | String | The pincode for the additional address, in this case, "400013." |
result.gstnDetailed.additionalAddressArray[0].latitude | String | The latitude for the additional address, in this case, "19.0008166692499." |
result.gstnDetailed.additionalAddressArray[0].longitude | String | The longitude for the additional address, in this case, "72.8289635211452." |
result.gstnDetailed.lastUpdatedDate | String | The date when the information was last updated, in the format "DD/MM/YYYY," e.g., "05/01/2023." |
result.gstnDetailed.principalPlaceSplitAddress.district | Array | An array containing the district information for the principal place of business, in this case, ["PUNE"]. |
result.gstnDetailed.principalPlaceSplitAddress.state | Array | An array containing the state information for the principal place of business, in this case, [["MAHARASHTRA", "MH"]]. |
result.gstnDetailed.principalPlaceSplitAddress.city | Array | An array containing the city information for the principal place of business, in this case, ["PASHAN"]. |
result.gstnDetailed.principalPlaceSplitAddress.pincode | String | The pincode for the principal place of business, in this case, "411021." |
result.gstnDetailed.principalPlaceSplitAddress.country | Array | An array containing country information for the principal place of business, in this case, ["IN", "IND", "INDIA"]. |
result.gstnDetailed.principalPlaceSplitAddress.addressLine | String | Concatenated address line for the principal place of business, in this case, "BANER LINK ROAD,18 B,KUBERA BAHAR BUNGLOWS,SOC 131 2." |
result.gstnDetailed.additionalPlaceSplitAddress.district | Array | An array containing the district information for the additional place of business, in this case, ["MUMBAI"]. |
result.gstnDetailed.additionalPlaceSplitAddress.state | Array | An array containing the state information for the additional place of business, in this case, [["MAHARASHTRA", "MH"]]. |
result.gstnDetailed.additionalPlaceSplitAddress.city | Array | An array containing the city information for the additional place of business, in this case, ["MUMBAI"]. |
result.gstnDetailed.additionalPlaceSplitAddress.pincode | String | The pincode for the additional place of business, in this case, "400013." |
result.gstnDetailed.additionalPlaceSplitAddress.country | Array | An array containing country information for the additional place of business, in this case, ["IN", "IND", "INDIA"]. |
result.gstnDetailed.additionalPlaceSplitAddress.addressLine | String | Concatenated address line for the additional place of business, in this case, "8TH FLOOR,UNIT 801-802,TOWER 1,ONE INTERNATIONAL CENTRE,SENAPATI BAPAT MARG." |
result.gstnRecords | Array | An array containing records related to GST registration. |
result.gstnRecords[0].applicationStatus | String | The application status for GST registration, if available. |
result.gstnRecords[0].registrationName | String | The registration name for GST, which is "SIGNZY TECHNOLOGIES PRIVATE LIMITED." |
result.gstnRecords[0].mobNum | String | The mobile number associated with GST registration, if available. |
result.gstnRecords[0].regType | String | The registration type for GST, if available. |
result.gstnRecords[0].emailId | String | The email address associated with GST registration, if available. |
result.gstnRecords[0].tinNumber | String | The TIN (Taxpayer Identification Number) associated with GST registration, if available. |
result.gstnRecords[0].gstinRefId | String | The GSTIN reference ID, if available. |
result.gstnRecords[0].gstin | String | The GSTIN (Goods and Services Tax Identification Number) for the business, in this case, "27AAWCS3552Q1ZA." |
result.gstin | String | The GSTIN (Goods and Services Tax Identification Number) for the business, in this case, "27AAWCS3552Q1ZA." |

// When authorization is not valid
{
"message": "Invalid authentication credentials"
}
// When authorization key is not given
{
"message": "No API key found in request"
}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!