GSTIN Search

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

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

Production

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