Search GSTIN
Goods and Service Tax Identification Number (GSTIN) is a unique 15-digit number issued to businesses registered under GST. Businesses can verify GSTIN using Sandbox API
Overview
The API takes in the GSTIN of a registered business and provides you with their information as available on the GST Portal.
Problem
- GSTIN verification is important for businesses as part of their KYC process
- Businesses can only verify one GSTIN at a time by visiting the GST portal.
Solution
- The Search GSTIN API provides the necessary data to automate the KYC of GST-registered businesses
Endpoint
HTTP Method | Resource | Description |
---|---|---|
GET | /gsp/public/gstin/:gstin | Returns GSTIN entity for given GSTIN |
Request
Follow the below guidelines to pass GSTIN for verification.
Path Parameters
Param | Type | Description | Example |
---|---|---|---|
gstin | string | 15-character alphanumeric unique identifier assigned to business entities registering under the GST regime | 24AAACJ3770E2ZV |
Sample CURL request
curl --location --request GET 'https://api.sandbox.co.in/gsp/public/gstin/24AAACJ3770E2ZZ' \
--header 'Authorization: eyJhbGciOiJIUzUxMiJ9.eyJhdWQiOiJBUEkiLCJyZWZyZXNoX3Rva2VuIjoiZXlKaGJHY2lPaUpJVXpVeE1pSjkuZXlKaGRXUWlPaUpCVUVraUxDSnpkV0lpT2lKclpYbGZiR2wyWlY5QlpHVXFLaW9xS2lvcUtpb3FLaW9xS2lvcUtpb3FLaW9xS2lvcUtsVjRjeUlzSW1Gd2FWOXJaWGtpT2lKclpYbGZiR2wyWlY5QlpHVXFLaW9xS2lvcUtpb3FLaW9xS2lvcUtpb3FLaW9xS2lvcUtsVjRjeUlzSW1semN5STZJbUZ3YVM1eGRXbGphMjh1WTI5dElpd2laWGh3SWpveE5Ua3dPVFk1TmpBd0xDSnBiblJsYm5RaU9pSlNSVVpTUlZOSVgxUlBTMFZPSWl3aWFXRjBJam94TlRVNU16UTNNakF3ZlEueHNmYkhQTERFRlRvTy1OUWdaUUpLM25OUjFxdlhvWmhaOHRqS3gzSExydjZiVkJaMHpJZEZ5ai1MUTg1YnJZS0xXQnFnZHlzZ1NDSXlDUXNtV2VOYkEiLCJzdWIiOiJqb2huQGRvZS5jb20iLCJhcGlfa2V5Ijoia2V5X2xpdmVfQWRlKioqKioqKioqKioqKioqKioqKioqKioqKipVeHMiLCJpc3MiOiJhcGkucXVpY2tvLmNvbSIsImV4cCI6MTU5MTA1NjAwMCwiaW50ZW50IjoiQUNDRVNTX1RPS0VOIiwiaWF0IjoxNTkwOTY5NjAwfQ.nH23CR5RHGQ0U19I_vq3vyJ_85A1a2iEMQij5QHgJQdDuS9x7FmTidsr1CQabSFF5ujE40SFxHv1gJM20TauUw' \
--header 'x-api-key: key_live_Ade**************************Uxs' \
--header 'x-api-version: 3.4.0'
Test Environment Available
Response
The response would have the following information
Param | Type | Description | Example |
---|---|---|---|
ctb | string | Constitution of Business | Private Limited Company |
ctj | string | Centre Jurisdiction | RANGE I |
ctjCd | string | Centre Jurisdiction Code | WS0601 |
cxdt | string | Date Of Cancellation | |
dty | string | Taxpayer type | Regular |
einvoiceStatus | string | Status of e-Invoice enablement | No |
gstin | string | GSTIN of the entity | 24AAACJ3770E2ZV |
lgnm | string | Legal Name of Business | JOHN DOE PRIVATE LIMITED |
lstupddt | string | Last Updated Date | 14/04/2018 |
nba | string | Nature of Business Activity | Service Provision |
rgdt | string | Date of Registration | 01/07/2017 |
stj | string | State Jurisdiction | Ghatak 9 (Ahmedabad) |
stjCd | string | State Jurisdiction Code | GJ009 |
sts | string | GSTN status | Active |
tradeNam | string | Trade Name | John Doe Private Limited |
adadr | object | Additional Place of Business Object | |
pradr | object | Principal Place of Business Object | |
addr | object | Place of Business Address Fields | Look Below |
ntr | string | Nature of Place of Business | Service Provision |
Place of Business Address fields
Param | Type | Description | Example |
---|---|---|---|
bnm | string | Building Name | ABC Lakeview Tower |
bno | string | Door Number | 123 |
dst | string | District | Ahmedabad |
flno | string | Floor Number | 1 |
geocodelvl | string | Geo Code Level | NA |
landMark | string | Landmark | - |
lg | string | Longitude | 1231223121 |
loc | string | Location | Vastrapur |
locality | string | Locality | |
lt | string | Lattitude | 1231231231 |
pncd | string | Pin Code | 380015 |
st | string | Street | Opp. Vastrapur Lake |
stcd | string | State name | Gujarat |
Response Caching
Response caching is not available for this API. Learn more about our response caching mechanism here
Wallet Charge
Since Search GSTIN is not a Paid API, no wallet charge will take place.
Versioning
This API is currently in major version 1.0. Refer to the below table for the versioning history of this API along with the Changelog.
Refer to our versioning policies here
Updated about 1 month ago