Search GSTIN By PAN
Permanent Account Number (PAN) is a 10-digit unique identifier for taxpayers in India. Businesses can use Sandbox APIs to fetch GSTN details using PAN.
Overview
The Search GSTIN API by PAN takes in the pan
of a business entity and its corresponding state_code
and provides you with the information of all the business entities that are associated with that corresponding of the pan
and state_code
.
Problem
- Businesses want to check all GSTINs associated with a PAN as part of their vendor onboarding process
Solution
- Search GSTIN by PAN provides you with the details of all the entities that are associated with the
pan
in the particularstate_code
.
Endpoint
HTTP Method | Resource | Description |
---|---|---|
GET | /gsp/public/pan/{pan} | Returns GSTIN entity for given PAN and State Code |
Request
Follow the below guidelines to pass PAN for getting GSTN details.
Path Parameters
Param | Type | Description | Example |
---|---|---|---|
pan | string | 10-character alpha-numeric unique identifier for tax payer | AAACJ3770E |
Query Parameters
Param | Type | Description | Example |
---|---|---|---|
state_code | string | GST state code | 24 |
At the end, you can find a comprehensive list of valid state codes.
Sample CURL request
curl --location --request GET 'https://api.sandbox.co.in/gsp/public/pan/AAACJ3770E?state_code=24' \
--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
Field | Type | Description | Example |
---|---|---|---|
stjCd | string | State Jurisdiction Code | GJ009 |
dty | string | Taxpayer type | Regular |
stj | string | State Jurisdiction | Ghatak 9 (Ahmedabad) |
lgnm | string | Legal Name of Business | John Doe Private Limited |
adadr | string | Additional Place of Business Fields | [] |
cxdt | string | Date Of Cancellation | "" |
gstin | string | GST Identification Number of Business | 24AAACJ3770E2ZZ |
nba | string | Nature of Business Activity | Service Provision |
lstupdt | string | Last Updated Date | 14/04/2018 |
ctb | string | Constitution of Business | Private Limited Company |
rgdt | string | Date of Registration | 01/07/2017 |
pradr | object | Pricipal Place of Business fields | Look |
bnm | string | Building Name | ABC Lakeview Tower |
st | string | Street | Opp. Vastrapur Lake |
loc | string | Location | Vastrapur |
bno | string | Door Number | 111 |
stcd | string | state name | Gujarat |
dst | string | District | Ahmedabad |
city | string | City | Ahmedabad |
flno | string | Floor Number | 09 |
It | string | lattitude | 12313211231 |
pncd | string | pin code | 560062 |
lg | string | longitude | 1231231 |
ntr | string | Nature of Additional place of business | Service Provision |
State Codes
State code | State |
---|---|
35 | Andaman & Nicobar Islands |
37 | Andhra Pradesh |
12 | Arunachal Pradesh |
18 | Assam |
10 | Bihar |
04 | Chandigarh |
22 | Chhattisgarh |
26 | Dadra & Nagar Haveli |
25 | Daman & Diu |
07 | Delhi |
30 | Goa |
24 | Gujarat |
06 | Haryana |
02 | Himachal Pradesh |
01 | Jammu & Kashmir |
20 | Jharkhand |
29 | Karnataka |
32 | Kerala |
31 | Lakshdweep |
23 | Madhya Pradesh |
27 | Maharashtra |
14 | Manipur |
17 | Meghalaya |
15 | Mizoram |
13 | Nagaland |
21 | Odisha |
97 | Other Territory |
34 | Puducherry |
03 | Punjab |
08 | Rajasthan |
11 | Sikkim |
33 | Tamil Nadu |
36 | Telangana |
16 | Tripura |
09 | Uttar Pradesh |
05 | Uttarakhand |
19 | West Bengal |
Wallet Charge
Since Search GSTIN By PAN is a Paid APIs, a wallet charge of INR 0.25 + GST per API call will be applicable.
Updated about 1 month ago