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 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 EndpointAPI Endpoint

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
lgnmstringLegal Name of BusinessJOHN DOE PRIVATE LIMITED
stjstringState JurisdictionGhatak 9 (Ahmedabad)
ctjstringCentre JurisdictionRANGE I
rgdtstringDate of Registration01/07/2017
ctbstringConstitution of BusinessPrivate Limited Company
dtystringTaxpayer typeRegular
nbastringNature of Business ActivityService Provision
stsstringGSTN statusActive
cxdtstringDate Of Cancellation
lstupddtstringLast Updated Date14/04/2018
stjCdstringState Jurisdiction CodeGJ009
ctjCdstringCentre Jurisdiction CodeWS0601
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
ststringStreetOpp. Vastrapur Lake
locstringLocationVastrapur
bnostringDoor Number123
stcdstringState nameGujarat
flnostringFloor Number1
ltstringLattitude1231231231
lgstringLongitude1231223121
pncdstringPin Code380015
ntrstringNature of pricipal place of BusinessService Provision
gstinstringGSTIN of the entity
diststringdistrict
citystringcity

Wallet Charge

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