GSTIN Search API

5 min

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.

The following information will be extracted :

Constitution of business
Legal name of business
Trade name of business
Centre Jurisdiction
State Jurisdiction
Registration Date
Date of tax payment
Tax payer type
Cancellation date
Nature of business activities
Principal place of address

How to call the API

You will need to login before sending GSTIN request. You are required to pass the access token received from the login call, as authorization header in the GSTIN request along with GSTIN Number

API Input Guidelines

Provide unique 15-digit alphanumeric GSTIN issued by the Goods and Services Tax department

Search by GSTIN

Get details of GSTIN

POST

https://preproduction.signzy.tech/api/v2/patrons/<Patron ID>/gstns


  curl --location --request POST 'https://preproduction.signzy.tech/api/v2/patrons/<Patron ID>/gstns' \
--header 'Content-Type: application/json' \
--header 'Authorization: <...token...>' \
--data-raw '{
    "task" : "gstinSearch",
    "essentials": {
      "gstin": "<GSTIN Number>"
    }
  }

Response Parameters

PARAMETER NAME	DESCRIPTION
task	The type of task to be performed - "GSTIN Search"
essentials	This parameter contains the essential data for generating output.
essentials.gstin	The GST number that is required for the GST Search.
essentials.state	The state to which the GST number is registered.
essentials.email	The email ID registered with the owner of the GST number.
id	The access token that was received during login request.
patronId	This parameter is returned as userId parameter of login request.
result	The final response parameters are displayed here.
result.gstnRecords	The detailed information associated with the records of the GST number are contained in this parameter.
gstnRecords.tinNumber	The TIN number associated with the GST number is displayed by this parameter.
gstnRecords.regType	The type of registration done for the GST number being searched is displayed by this parameter.
gstnRecords.gstinRefId	The reference ID associated with the GSTIN is contained in this parameter.
gstnRecords.applicationStatus	The current status of the application of the GST number.
gstnRecords.registrationName	The registration name of the individual/business owner associated with the GST number.
gstnRecords.mobNum	The mobile number of the individual/ business owner associated with the GST number.
gstnRecords.emailId	The email ID of the individual/ business owner associated with the GST number.
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”.

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].