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

Suggest Edits

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.

Version	Description	Endpoint
1.0	This is the first version of the API

Refer to our versioning policies here

Updated about 1 month ago