Parent API: GST API Quickstart guide Authentication guide

Search All GSTINs Registered to a PAN

Q: What query parameters are required to search taxpayers by PAN?

The request requires 'pan' (the 10-character Permanent Account Number) and 'email' (user email) as query parameters, along with 'client_id' and 'client_secret' in the headers. No OTP session is required as this is a public registry lookup.

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

This API will be used to get all the list of GSTIN for a PAN

Parameters

query parameters

emailstringrequired

User Email

panstringrequired

PAN Number

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 pan (the 10-character Permanent Account Number) and email (user email) as query parameters, along with client_id and client_secret in the headers. No OTP session is required as this is a public registry lookup.

The response returns the complete list of GSTINs registered against the supplied PAN, covering all states and union territories. This is useful for verifying multi-state GST registrations for a single legal entity or individual.

GET /public/search looks up taxpayer profile details for a single known GSTIN. GET /public/searchbypan works in the reverse direction — you provide a PAN and get back all associated GSTINs, enabling discovery of all GST registrations for an entity.

Yes. The 10-character alphanumeric PAN format is validated at the API gateway level before the request reaches GSTN. Malformed or structurally invalid PANs return a format error immediately.

Get Preference

Unregistered Applicants API

GET/public/searchbypan

1const response = await fetch('https://apisandbox.whitebooks.in/public/searchbypan?email=value&pan=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.