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

API Pricing Image

Overview

The API takes in 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 MethodResourceDescription
GET/gsp/public/gstin/:gstinReturns GSTIN entity for given GSTIN

API Endpoint  Contact Us  Free Trial

Request

Follow the below guidelines to pass GSTIN for verification.

Path Parameters

ParamTypeDescriptionExample
gstinstring15-character alphanumeric unique identifier assigned to business entities registering under the GST regime24AAACJ3770E2ZV

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

ParamTypeDescriptionExample
ctbstringConstitution of BusinessPrivate Limited Company
ctjstringCentre JurisdictionRANGE I
ctjCdstringCentre Jurisdiction CodeWS0601
cxdtstringDate Of Cancellation
dtystringTaxpayer typeRegular
einvoiceStatusstringStatus of e-InvoiceNo
gstinstringGSTIN of the entity24AAACJ3770E2ZV
lgnmstringLegal Name of BusinessJOHN DOE PRIVATE LIMITED
lstupddtstringLast Updated Date14/04/2018
nbastringNature of Business ActivityService Provision
rgdtstringDate of Registration01/07/2017
stjstringState JurisdictionGhatak 9 (Ahmedabad)
stjCdstringState Jurisdiction CodeGJ009
stsstringGSTN statusActive
tradeNamstringTrade NameJohn Doe Private Limited
adadrstringAdditional Place of Business Fields[]
pradrobjectPricipal Place of Business fieldsLook Below :point-down:
addrobjectPricipal Place of Business AddressLook Below :point-down:
bnmobjectBuilding NameABC Lakeview Tower
bnostringDoor Number123
dststringDistrictAhmedabad
flnostringFloor Number1
geocodelvlstringGeo Code LevelNA
landMarkstringLandmark-
lgstringLongitude1231223121
locstringLocationVastrapur
localitystringLocality
ltstringLattitude1231231231
pncdstringPin Code380015
ststringStreetOpp. Vastrapur Lake
stcdstringState nameGujarat
ntrstringNature of pricipal place of BusinessService Provision
einvoiceStatusstringStatus of e-InvoicingNo

Response Caching

Response caching is not available for this API. Learn more about our response caching mechanism here

Wallet Charge

Since Search GSTIN is a Paid APIs, a wallet charge of INR 0.25 + GST per API call will be applicable.

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.

VersionDescriptionEndpoint
1.0This is the first version of the APIAPI Endpoint

Refer to our versioning policies here