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/search

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

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	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!