GSTIN Search API
3 min
Introduction
The GSTIN Search API provides a straightforward method to retrieve Goods and Services Tax (GST) details by searching for a specific GST Identification Number (GSTIN). GSTIN is a unique identification number assigned to registered taxpayers in India. With this API, developers can seamlessly integrate GSTIN search functionality into their applications, enabling users to obtain accurate and up-to-date GST information effortlessly.
curl --request POST \
--url http://preproduction.signzy.tech/api/v2/patrons/..your-patron-id../gstns \
--header 'Accept: */*' \
--header 'Accept-Language: en-US,en;q=0.8' \
--header 'Authorization: <Access-Token>' \
--header 'content-type: application/json' \
--data '{"task":"gstnSearch","essentials":{"gstin":"...gstin..."}}'Request Parameters
Parameter | Description |
|---|---|
task | Specifies the task to be performed by the API. In this case, "gstnSearch" indicates searching based on GSTIN. |
essentials | An object containing essential parameters for the GSTIN search. |
gstin | The GST Identification Number (GSTIN) for which the GST details are to be retrieved. |
Sample Response
{
"result":{
"gstnRecords":[
{
"regType":"..registrationType...",
"emailId":"..emailId...",
"applicationStatus":"...application Status...",
"registrationName":"...registered Name...",
"gstinRefId":"...GSTIN Reference Id...",
"tinNumber":"...Tin Number...",
"mobNum":"...Mobile Number...",
"gstin":"...gstin Number..."
}
],
"gstnDetailed":{
"constitutionOfBusiness":"....Constitution Of Business...",
"legalNameOfBusiness":"....Name Of Business...",
"tradeNameOfBusiness":"....Trade Name Of Business...",
"centreJurisdiction":"....Centre Of Jurisdiction...",
"stateJurisdiction":"....State Of Jurisdiction...",
"registrationDate":"...Date of Registration...",
"taxPayerDate":"...Tax Payer Date...",
"taxPayerType":"...Tax Payer Type...",
"gstinStatus":"..GSTIN Status...",
"cancellationDate":"..cancellation Date...",
"e-invoicingStatus":"...e-invoicingStatus...",
"natureOfBusinessActivities":[
"...Nature of Business Activities..."
],
"principalPlaceAddress":"...Principal Address of the entity registered in GST...",
"principalPlaceLatitude":"...Principal Latitude of the entity registered in GST...",
"principalPlaceLongitude":"...Principal Longitude of the entity registered in GST...",
"principalPlaceBuildingNameFromGST":"...Bulding Name of Principal Address of the entity registered in GST...",
"principalPlaceBuildingNoFromGST":"...Bulding No of Principal Address of the entity registered in GST...",
"principalPlaceFlatNo":"...Flat No of Principal Address of the entity registered in GST...",
"principalPlaceStreet":"...Street of Principal Address of the entity registered in GST...",
"principalPlaceLocality":"...Locality of Principal Address of the entity registered in GST...",
"principalPlaceCity":"...City of Principal Address of the entity registered in GST...",
"principalPlaceDistrict":"...District of Principal Address of the entity registered in GST...",
"principalPlaceState":"...State of Principal Address of the entity registered in GST...",
"principalPlacePincode":"...Pincode of Principal Address of the entity registered in GST...",
"additionalPlaceAddress":"...Additional Address of the entity registered in GST...",
"additionalPlaceLatitude":"...Additional Latitude of the entity registered in GST...",
"additionalPlaceLongitude":"...Additional Longitude of the entity registered in GST...",
"additionalPlaceBuildingNameFromGST":"...Bulding Name of Additional Address of the entity registered in GST...",
"additionalPlaceBuildingNoFromGST":"...Bulding No of Additional Address of the entity registered in GST...",
"additionalPlaceFlatNo":"...Flat No of Additional Address of the entity registered in GST...",
"additionalPlaceStreet":"...Street of Additional Address of the entity registered in GST...",
"additionalPlaceLocality":"...Locality of Additional Address of the entity registered in GST...",
"additionalPlaceCity":"...City of Additional Address of the entity registered in GST...",
"additionalPlaceDistrict":"...District of Additional Address of the entity registered in GST...",
"additionalPlaceState":"...State of Additional Address of the entity registered in GST...",
"additionalPlacePincode":"...Pincode of Additional Address of the entity registered in GST...",
"principalPlaceSplitAddress":{
"state":[
[
]
],
"district":[
],
"city":[
],
"pincode":"...pincode...",
"country":[
"IN",
"IND",
"INDIA"
],
"addressLine":"...addressLine..."
},
"additionalPlaceSplitAddress":{
"state":[
[
]
],
"district":[
],
"city":[
],
"pincode":"...pincode...",
"country":[
"IN",
"IND",
"INDIA"
],
"addressLine":"...addressLine..."
},
"additionalAddressArray":[
{
"address":"...address...""street":"...street...",
"locality":"...locality...",
"buildingNo":"...buildingNo...",
"buildingName":"...buildingName...",
"district":"...district...",
"city":"...city...",
"state":"...state...",
"flatNo":"...flatNo...",
"latitude":"...latitude...",
"pincode":"...pincode...",
"longitude":"...longitude..."
}
]
},
"lastUpdatedDate":"...lastUpdatedDate...",
"gstin": "...gstin Number..."
}
}