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
panin 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.