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.
To use the "Search by GSTIN" API, you need to send a HTTP POST request to the API endpoint with the following details:
Note: Replace {patronId} with your actual patron ID.
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 |
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 |
The "Search by GSTIN" API returns a JSON object containing detailed information related to the requested GSTIN.
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. |
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. |