About

The Search GSTIN API takes in the gstin of a business entity and provides you the information of *the business entities as registered on the GST Portal.

The Search GSTIN API provides you the necessary information to verify an entity onboarding onto your workflow. For example, you can cross-check the information provided to you against the information available on the GST Portal using this API.

Usecase

An E-commerce platform has to verify businesses coming onboard on their platform. By cross-checking the information provided by the API, the E-commerce platform can verify the businesses.

Endpoint

HTTP Method	Resource	Description
`GET`	/gsp/public/gstin/:gstin	Returns GSTIN entity for given GSTIN

Path Parameters

Param	Type	Description	Example
gstin	`string`	15-character alphanumeric unique identifier assigned to business entities registering under the GST regime	24AAACJ3770E2ZV

Response

Param	Type	Description	Example
lgnm	`string`	Legal Name of Business	JOHN DOE PRIVATE LIMITED
stj	`string`	State Jurisdiction	Ghatak 9 (Ahmedabad)
ctj	`string`	Centre Jurisdiction	RANGE I
rgdt	`string`	Date of Registration	01/07/2017
ctb	`string`	Constitution of Business	Private Limited Company
dty	`string`	Taxpayer type	Regular
nba	`string`	Nature of Business Activity	Service Provision
sts	`string`	GSTN status	Active
cxdt	`string`	Date Of Cancellation
lstupddt	`string`	Last Updated Date	14/04/2018
stjCd	`string`	State Jurisdiction Code	GJ009
ctjCd	`string`	Centre Jurisdiction Code	WS0601
tradeNam	`string`	Trade Name	John Doe Private Limited
adadr	`string`	Additional Place of Business Fields	[]
addr	`object`	Additional place of business address.	Look Below
bnm	`string`	Building Name	ABC Lakeview Tower
st	`string`	Street	Opp. Vastrapur Lake
loc	`string`	Location	Vastrapur
bno	`string`	Door Number	123
stcd	`string`	state name	Gujrat
flno	`string`	floor nbr	2
lt	`string`	lattitude	123123123
lg	`string`	longitude	123123123
pncd	`string`	pin code	380015
ntr	`string`	Nature of Additional place of business	Service Provision
pradr	`string`	Pricipal Place of Business fields	Look Below
addr	`object`	Pricipal Place of Business Address	Look Below
bnm	`object`	Building Name	ABC Lakeview Tower
st	`string`	Street	Opp. Vastrapur Lake
loc	`string`	Location	Vastrapur
bno	`string`	Door Number	123
stcd	`string`	State name	Gujarat
flno	`string`	Floor Number	1
lt	`string`	Lattitude	1231231231
lg	`string`	Longitude	1231223121
pncd	`string`	Pin Code	380015
ntr	`string`	Nature of pricipal place of Business	Service Provision