GSTIN Search
Introduction
Every GST Certificate holds a unique 15-digit alphanumeric GST Identification Number or GSTIN for the business. This is just like the ID number on any other ID card. Using the GSTIN-Based Search API, Signzy uses its proprietary algorithms to extract the details of the GSTIN-registered business and its owner.
How to call the API
You must first login before sending the request. The authorization header in the request must include the access token obtained from the login API call.
API Input Guidelines
Need to pass the following information
- gstin
Sample Curl
curl --location --request POST 'https://api.signzy.app/api/v3/gstin/basic-search-premium' \
--header 'Authorization: <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"gstin": "<GST Number>"
}'
Input Parameters
PARAMETER NAME | Required/Optional | DESCRIPTION |
|---|---|---|
Authorization | Required | Contains the id parameter returned from the login step |
Content-Type | Required | application/json |
gstin | Required | GSTIN number to be searched |
Sample Response
{
"result": {
"gstin": "27AOKPP9482P1ZQ",
"gstnDetailed": {
"constitutionOfBusiness": "PROPRIETORSHIP",
"legalNameOfBusiness": "SAGAR MAHESHKUMAR PATEL",
"tradeNameOfBusiness": "ASHISH ENGINEERING WORKS",
"centreJurisdiction": "RANGE-I",
"stateJurisdiction": "MALAD-WEST_704",
"registrationDate": "01/07/2017",
"taxPayerDate": "",
"taxPayerType": "REGULAR",
"gstinStatus": "ACTIVE",
"cancellationDate": "",
"natureOfBusinessActivities": [
"OFFICE / SALE OFFICE"
],
"principalPlaceAddress": "11TH RUSTOMJEE RIVIERA BLDG., A-1102,MARVE ROAD,MALAD WEST,MUMBAI SUBURBAN,MAHARASHTRA,400064",
"principalPlaceLatitude": "",
"principalPlaceLongitude": "",
"principalPlaceBuildingNameFromGST": "RUSTOMJEE RIVIERA BLDG.,",
"principalPlaceBuildingNoFromGST": "A-1102",
"principalPlaceFlatNo": "11TH",
"principalPlaceStreet": "MARVE ROAD",
"principalPlaceLocality": "MALAD WEST",
"principalPlaceCity": "",
"principalPlaceDistrict": "MUMBAI SUBURBAN",
"principalPlaceState": "MAHARASHTRA",
"principalPlacePincode": "400064",
"additionalPlaceAddress": "BOMBAY TALKIES COMPOUND 179,OPP. SHED NO. 35,MALAD WEST,MUMBAI SUBURBAN,MAHARASHTRA,400064",
"additionalPlaceLatitude": "",
"additionalPlaceLongitude": "",
"additionalPlaceBuildingNameFromGST": "Bombay Talkies Compound",
"additionalPlaceBuildingNoFromGST": "179",
"additionalPlaceFlatNo": "",
"additionalPlaceStreet": "Opp. Shed No. 35",
"additionalPlaceLocality": "Malad West",
"additionalPlaceCity": "",
"additionalPlaceDistrict": "Mumbai Suburban",
"additionalPlaceState": "Maharashtra",
"additionalPlacePincode": "400064",
"additionalAddressArray": [
{
"address": "179,OPP. SHED NO. 35,MALAD WEST,MAHARASHTRA,400064",
"flatNo": "",
"street": "D.K. Sandhu Marg",
"locality": "Malad West",
"buildingNo": "179",
"buildingName": "Bombay Talkies Compound",
"district": "Mumbai Suburban",
"city": "",
"state": "Maharashtra",
"pincode": "400064",
"latitude": "",
"longitude": ""
}
],
"lastUpdatedDate": "07/09/2019"
}
}
}
Response Parameter
PARAMETER NAME | DESCRIPTION |
|---|---|
gstnRecords.gstin | The GST identification number for which PAN number is being searched. |
result.gstnDetailed | This parameter provides detailed information about the owner/business to which the GST number has been assigned. |
gstnDetailed.constitutionOfBusiness | This parameter denotes the type of company or organisation i.e Public or Private Limited Company. |
gstnDetailed.legalNameOfBusiness | The legal name of the business as registered with the GST number. |
gstnDetailed.tradeNameOfBusiness | The trading/commercial name under which the company/organization operates. |
gstnDetailed.centreJurisdiction | This parameter assigns a code that depicts jurisdiction of the central government on the company. |
gstnDetailed.stateJurisdiction | This parameter assigns a code that depicts jurisdiction of the state government on the company. |
gstnDetailed.registrationDate | The date of registration of GST for the business/organization is displayed by this parameter. |
gstnDetailed.taxPayerDate | The due date for the taxpayer associated with the GST number. |
gstnDetailed.taxPayerType | This parameter denotes the type of taxpayer i.e regular taxpayer. |
gstnDetailed.gstinStatus | The current status of the GST identification number is active/inactive. |
gstnDetailed.cancellationDate | This parameter shows the date of cancellation for the GST if applicable. |
gstnDetailed.natureOfBusinessActivities | This parameter shows the type of business provider. Ex: Supplier of Services. |
gstnDetailed.principalPlaceAddress | The address of the business/organization as registered with GST number. |
gstnDetailed.principalPlaceLatitude | The latitude coordinates of the principal place of address. |
gstnDetailed.principalPlaceLongitude | The longitude coordinates of the principal place of address. |
gstnDetailed.principalPlaceBuildingNameFromGST | The name of the building where the business/organization is located. |
gstnDetailed.principalPlaceBuildingNoFromGST | The building number where the business/organization is located. |
gstnDetailed.principalPlaceFlatNo | The flat number in the building where the business/organization is located. |
gstnDetailed.principalPlaceStreet | The street name where the business/organization is located. |
gstnDetailed.principalPlaceLocality | The locality where the business/organization is located. |
gstnDetailed.principalPlaceCity | The city where the business/organization is located. |
gstnDetailed.principalPlaceDistrict | The district where the business/organization is located. |
gstnDetailed.principalPlaceState | The state where the business/organization is located. |
gstnDetailed.principalPlacePincode | The pincode where the business/organization is located. |
gstnDetailed.additionalPlaceAddress | This parameter displays the address for any secondary/branch office associated with the business/organization. |
gstnDetailed.additionalPlaceLatitude | The latitude coordinates of the additional place of address. |
gstnDetailed.additionalPlaceLongitude | The longitude coordinates of the additional place of address. |
gstnDetailed.additionalPlaceBuildingNameFromGST | The name of the building where the additional place of the business/organization is located. |
gstnDetailed.additionalPlaceBuildingNoFromGST | The building number of the additional place of the business/organization is located. |
gstnDetailed.additionalPlaceFlatNo | The flat number of the building where the additional place of the business/organization is located. |
gstnDetailed.additionalPlaceStreet | The street name of the building where the additional place of the business/organization is located. |
gstnDetailed.additionalPlaceLocality | The locality of the building where the additional place of the business/organization is located. |
gstnDetailed.additionalPlaceCity | The city where the additional place of the business/organization is located. |
gstnDetailed.additionalPlaceDistrict | The district where the additional place of the business/organization is located. |
gstnDetailed.additionalPlaceState | The state where the additional place of the business/organization is located. |
gstnDetailed.additionalPlacePincode | The pincode where the additional place of the business/organization is located. |
gstnDetailed.gstin | The GST identification number. |
gstnDetailed.principalPlaceSplitAddress | This parameter distinguishes the various parts of the address of the principal place of business into separate categories like district, state, city, pincode and country. For the country category, acceptable values are “IN”,”IND”and”INDIA”. |
gstnDetailed.additionalPlaceSplitAddress | This parameter distinguishes the various parts of the address of the additional place of business into separate categories like district, state, city, pincode and country. For the country category, acceptable values are “IN”,”IND”and”INDIA”. |
address | the particulars of the place where someone lives or an organization is situated. |
flatNo | Number of the house |
street | street name on which the house is located |
locality | locality in which the house is located |
buildingNo | number of the building |
buildingName | name of the building |
district | the name of the district |
city | the city name |
state | name of the state |
pincode | pincode for eg: 201303 |
latitude | the coordinates |
longitude | the coordinates |
gstnDetailed.lastUpdatedDate | last updated date of the details by the user |
Error Codes
{
"message": "Invalid authentication credentials"
}CODE | DESCRIPTION | INTERPRETATION |
|---|---|---|
400 | Bad Request | Input Parameter has a missing required parameter |
401 | Authorization Failed | This error occurs when the authorization token in the request header is invalid or has expired. |
404 | Data not found | the GSTIN you provided in the API request is not found. |
409 | Upstream Error | Upstream is down, Please contact support for assistance in resolving this issue. |
500 | Internal Server Error | Internal error at Signzy, Please contact support for assistance in resolving this issue. |
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].