Search by GSTIN V2

The "Search by GSTIN" API is a powerful RESTful web service that allows users to search for and retrieve detailed information related to any Goods and Services Tax Identification Number (GSTIN) in India. This API is designed to be fast, reliable, and easy to use, with a simple and intuitive interface that makes it accessible to users with varying levels of technical expertise.

The API can be accessed using a simple HTTP request, and the response is returned in JSON format. The information provided by the API includes the constitution of the business, legal and trade names, registration and cancellation dates, taxpayer type and status, e-invoicing status, nature of business activities, and principal and additional place of business addresses. All the information is obtained from the official GSTN portal and is updated regularly to ensure accuracy and completeness.

The "Search by GSTIN" API is particularly useful for businesses and individuals who need to verify the validity of a GSTIN or obtain information about a specific business or organization. It can be integrated seamlessly into a wide range of applications, including ERP systems, accounting software, e-commerce platforms, and more.

V2 gateway API specifications

curl --location 'https://signzy.tech//api/v2/patrons/{patronId}/gstns' \
--header 'Content-Type: application/json' \
--header 'Authorization: {apiKey}' \
--data '{
    "task" : "gstinSearch",
    "essentials": {
      "gstin": "20AGRPG2101P1ZL"
    }
  }'

To use the "Search by GSTIN" API, you need to send a HTTP POST request to the API endpoint with the following details:

Request URL

https://signzy.tech/api/v2/patrons/{patronId}/gstns

Note: Replace {patronId} with your actual patron ID.

Request Headers

The following headers must be included in the request:

Header	Value
Content-Type	application/json
Authorization	Your API token that you get from login API

Request Body

The request body must be a JSON object with the following keys:

Key	Value Type	Required	Description
task	string	Yes	Set to "gstinSearch" to perform a GSTIN search
essentials	object	Yes	An object containing GSTIN to search for

gstin	string	Yes	GSTIN for which to retrieve information

Response

The "Search by GSTIN" API returns a JSON object containing detailed information related to the requested GSTIN.

Response Format

The response will be a JSON object with the following keys:

Key	Value Type	Description
task	string	Set to "gstinSearch" to indicate the type of task performed.
id	string	Unique identifier for the response.
patronId	string	Patron ID of the user making the request.
result	object	Object containing the detailed information related to the requested GSTIN.

The result object contains the following keys:

Key	Value Type	Description
gstnDetailed	object	Object containing detailed information related to the requested GSTIN.
gstnRecords	array	Array of GSTN records associated with the requested GSTIN.
gstin	string	GSTIN for which information is retrieved.

gstnDetailed Object

The gstnDetailed object contains the following keys:

Key	Value Type	Description
constitutionOfBusiness	string	Constitution of the business.
legalNameOfBusiness	string	Legal name of the business.
tradeNameOfBusiness	string	Trade name of the business.
centreJurisdiction	string	Centre jurisdiction of the business.
stateJurisdiction	string	State jurisdiction of the business.
registrationDate	string	Registration date of the business.
taxPayerDate	string	Taxpayer date of the business.
taxPayerType	string	Taxpayer type of the business.
gstinStatus	string	GSTIN status of the business.
cancellationDate	string	Cancellation date of the business.
e-invoicingStatus	string	E-invoicing status of the business.
natureOfBusinessActivities	array	Array of nature of business activities associated with the business.
principalPlaceAddress	string	Principal place of business address of the business.