Parent API: GST API Quickstart guide Authentication guide

GSTIN Taxpayer Search API

Q: What query parameters are required to search a taxpayer?

The request requires 'gstin' (the 15-character Goods and Services Tax Identification Number) as query parameter, authenticated with 'Authorization: Bearer ' and 'x-api-key' in request headers.

GEThttps://apisandbox.whitebooks.in/public/search

This API will be used to search taxpayer details

Parameters

query parameters

emailstringrequired

User Email

gstinstringrequired

GSTIN of the taxpayer

header parameters

client_idstringrequired

Client ID

client_secretstringrequired

Client Secret

Response

Not Found. If requested entity is not found or if requested API is not found.

Frequently Asked Questions

The request requires gstin (the 15-character Goods and Services Tax Identification Number) as query parameter, authenticated with Authorization: Bearer <access_token> and x-api-key in request headers.

The response returns verified GSTN registry information including legal name (lgnm), trade name (tradeNam), status (Active, Cancelled, Suspended), taxpayer type (Regular, Composition), date of registration, center and state jurisdictions, and principal place of business address.

Yes. The 15-character alphanumeric format and the 15th check digit are validated against the standard GSTIN algorithm. Malformed GSTINs fail with format errors before querying the central registry.

Yes. The public taxpayer search queries the public GSTN directory and does not require an active taxpayer OTP session, unlike return-filing and ledger-access endpoints.

View and Track Returns

GET/public/search

1const response = await fetch('https://apisandbox.whitebooks.in/public/search?email=value&gstin=value', {

2 method: 'GET',

3 headers: {

4 client_id: "value",

5 client_secret: "value"

6},

7});

9const data = await response.json();

10console.log(data);

No example available.