Detailed GSTIN Search API
3 min
Introduction
The Detailed GSTIN Search API provides an advanced method to retrieve comprehensive Goods and Services Tax (GST) details based on a specific GST Identification Number (GSTIN). GSTIN is a unique identification number assigned to registered taxpayers in India. This API enables developers to seamlessly integrate detailed GST information into their applications, empowering users to access extensive details and gain deeper insights into a business's GST compliance.
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":"detailedGstinSearch","essentials":{"gstin":"...gstin..."}}'Request Parameters
task | Specifies the task to be performed by the API. In this case, "detailedGstinSearch" for detailed GSTIN search. |
|---|---|
essentials | An object containing essential parameters for the detailed GSTIN search. |
gstin | The GST Identification Number (GSTIN) for which the comprehensive GST details are to be retrieved. |
Sample Response
{
"task" : "detailedGstinSearch",
"essentials": {
"gstin": "..gstin..",
"returnFilingFrequency": true/false (Optional)
},
"id": "...accessToken...",
"patronId": "...patronId...",
"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...",
"centreJurisdiction": "....Centre Of Jurisdiction...",
"stateJurisdiction": "....State Of Jurisdiction...",
"registrationDate": "...Date of Registration...",
"taxPayerDate": "...Tax Payer Date...",
"gstinStatus": "..GSTIN Status...",
"cancellationDate": "..cancellation Date...",
"natureOfBusinessActivities": [
"...Nature of Business Activities..."
],
"complianceRating": "...complianceRating...",
"directorNames": [
"...directorNames..."
],
"taxPayerType": "...taxPayerType...",
"tradeNameOfBusiness": "...tradeNameOfBusiness...",
"principalPlaceLatitude": "...principalPlaceLatitude...",
"principalPlaceLongitude": "...principalPlaceLongitude...",
"principalPlaceStreet": "...principalPlaceStreet...",
"principalPlaceLocality": "...principalPlaceLocality...",
"principalPlaceCity": "...principalPlaceCity...",
"principalPlaceDistrict": "...principalPlaceDistrict...",
"principalPlaceState": "...principalPlaceState...",
"principalPlacePincode": "...principalPlacePincode...",
"additionalPlaceLatitude": "...additionalPlaceLatitude...",
"additionalPlaceLongitude": "...additionalPlaceLongitude...",
"additionalPlaceStreet": "...additionalPlaceStreet...",
"additionalPlaceLocality": "...additionalPlaceLocality...",
"additionalPlaceCity": "...additionalPlaceCity...",
"additionalPlaceDistrict": "...additionalPlaceDistrict...",
"additionalPlaceState": "...additionalPlaceState...",
"additionalPlacePincode": "...additionalPlacePincode...",
"principalPlaceAddress": {
"emailId": "..emailId..",
"address": "..address..",
"natureOfBusiness": "...natureOfBusiness...",
"mobile": "...mobile...",
"lastUpdatedDate": "",
"splitAddress": {
"state": [
[]
],
"district": [],
"city": [],
"pincode": "...pincode...",
"country": [
"IN",
"IND",
"INDIA"
],
"addressLine": "...addressLine..."
}
},
"additionalPlaceAddress": [
{
"emailId": "..emailId..",
"address": "..address..",
"natureOfBusiness": "...natureOfBusiness...",
"mobile": "...mobile...",
"lastUpdatedDate": "",
"splitAddress": {
"state": [
[]
],
"district": [],
"city": [],
"pincode": "...pincode...",
"country": [
"IN",
"IND",
"INDIA"
],
"addressLine": "...addressLine..."
}
}],
"gstin": "...gstin Number...",
"annualAggregateTurnOver" : "....annualAggregateTurnOver....",
"grossTotalIncome" : "....grossTotalIncome....",
"grossTotalIncomeFinancialYear" : "....grossTotalIncomeFinancialYear....",
"aadhaarValidation": false,
"filingStatus": [
{
"filingYear": "...filingYear...",
"monthOfFiling": "...monthOfFiling...",
"methodOfFilling": "...methodOfFilling...",
"dateOfFiling": "...dateOfFiling...",
"gstType": "...gstType...",
"annualReturn": "...annualReturn...",
"gstStatus": "...gstStatus..."
}
],
"returnFilingFrequency": [
{
"financialYear": "2022-2023",
"returnFilingType": "GSTR1",
"frequency": "Monthly",
"quarter": "Apr-Jun"
},
{
"financialYear": "2022-2023",
"returnFilingType": "GSTR1",
"frequency": "Monthly",
"quarter": "Jul-Sep"
},
{
"financialYear": "2022-2023",
"returnFilingType": "GSTR1",
"frequency": "Quarterly",
"quarter": "Oct-Dec"
},
{
"financialYear": "2022-2023",
"returnFilingType": "GSTR1",
"frequency": "",
"quarter": "Jan-Mar"
},
{
"financialYear": "2022-2023",
"returnFilingType": "GSTR3B",
"frequency": "Quarterly",
"quarter": "Apr-Jun"
},
{
"financialYear": "2022-2023",
"returnFilingType": "GSTR3B",
"frequency": "Quarterly",
"quarter": "Jul-Sep"
},
{
"financialYear": "2022-2023",
"returnFilingType": "GSTR3B",
"frequency": "Quarterly",
"quarter": "Oct-Dec"
},
{
"financialYear": "2022-2023",
"returnFilingType": "GSTR3B",
"frequency": "",
"quarter": "Jan-Mar"
},
{
"financialYear": "2021-2022",
"returnFilingType": "GSTR1",
"frequency": "",
"quarter": "Apr-Jun"
},
{
"financialYear": "2021-2022",
"returnFilingType": "GSTR1",
"frequency": "",
"quarter": "Jul-Sep"
},
{
"financialYear": "2021-2022",
"returnFilingType": "GSTR1",
"frequency": "Monthly",
"quarter": "Oct-Dec"
},
{
"financialYear": "2021-2022",
"returnFilingType": "GSTR1",
"frequency": "Monthly",
"quarter": "Jan-Mar"
},
{
"financialYear": "2021-2022",
"returnFilingType": "GSTR3B",
"frequency": "Monthly",
"quarter": "Apr-Jun"
},
{
"financialYear": "2021-2022",
"returnFilingType": "GSTR3B",
"frequency": "Monthly",
"quarter": "Jul-Sep"
},
{
"financialYear": "2021-2022",
"returnFilingType": "GSTR3B",
"frequency": "Quarterly",
"quarter": "Oct-Dec"
},
{
"financialYear": "2021-2022",
"returnFilingType": "GSTR3B",
"frequency": "Quarterly",
"quarter": "Jan-Mar"
},
{
"financialYear": "2021-2022",
"returnFilingType": "GSTR9",
"frequency": "Annual",
"quarter": ""
}
]
}
}
}