Early accessWe're onboarding teams in batches. The sandbox and docs are open to everyone. Request access →

Skip to content
APIserver.in

GST by PAN

Every GST registration behind one PAN, across states.

POST/v1/gst/by-pan

₹1.00

per successful call · incl. GST · failed calls ₹0

What it does

Lists every GSTIN registered against a PAN, with state, status and registration date for each.

Input
PAN
Output
All GSTINs linked to the PAN

Use cases

  • Multi-state vendor mapping
  • Place-of-supply checks
  • Group exposure analysis

Request

curl https://api.apiserver.in/v1/gst/by-pan \
  -H "Authorization: Bearer as_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pan":"AABCT6639L"}'
const res = await fetch("https://api.apiserver.in/v1/gst/by-pan", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.APISERVER_KEY ?? "as_test_YOUR_KEY"}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "pan": "AABCT6639L"
  }),
});

const { success, data, meta, error } = await res.json();
console.log(meta.charged, meta.amount_inr); // failed calls are never charged
import os, requests

res = requests.post(
    "https://api.apiserver.in/v1/gst/by-pan",
    headers={
        "Authorization": f"Bearer {os.getenv('APISERVER_KEY', 'as_test_YOUR_KEY')}",
    },
    json={
        "pan": "AABCT6639L",
    },
    timeout=10,
)
body = res.json()
print(body["meta"]["charged"], body["meta"]["amount_inr"])
<?php
$ch = curl_init('https://api.apiserver.in/v1/gst/by-pan');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . (getenv('APISERVER_KEY') ?: 'as_test_YOUR_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'pan' => 'AABCT6639L',
    ]),
]);
$body = json_decode(curl_exec($ch), true);
echo $body['meta']['charged'] ? 'charged' : 'not charged';
Request body fields
FieldTypeDescription
panrequiredstring10-character PAN. The 4th character encodes the holder type.

Response

Sample response for a fictional sandbox entity. Click any key to copy its JSON path.

{  : true,  : "as_req_01J9X2K7R8M4V6T2Q9W3E5Y1ZB",  : "gst.by_pan",  : "2026-10-01",  : {    : "AABCT6639L",    : 3,    : [      {        : "27AABCT6639L1ZU",        : "Maharashtra",        : "27",        : "Active",        : "2017-07-01"      },      {        : "27AABCT6639L2ZT",        : "Maharashtra",        : "27",        : "Active",        : "2020-01-09"      },      {        : "24AABCT6639L1Z0",        : "Gujarat",        : "24",        : "Active",        : "2018-05-23"      }    ]  },  : {    : true,    : 1,    : 297,    : "live",    : 1,    : "2026-10-03T09:12:00+05:30",    : "live"  }}

Field dictionary — data

Response data fields
FieldTypeDescription
panstring—
countinteger—
gstinsobject[]—
↳gstinstring—
↳statestring—
↳state_codestring—
↳status"Active" | "Cancelled" | "Suspended"—
↳registration_datestring—

Errors

Every error uses the same envelope and is billed ₹0 — `meta.charged` is always false.

Errors this endpoint can return
HTTPCodeWhat it meansRetryBilled
400VALIDATION_FAILEDSomething in the request isn't in the right shape — usually an ID with a typo or a missing field.no₹0
401AUTH_INVALID_KEYWe couldn't find a valid API key on this request.no₹0
402WALLET_INSUFFICIENT_BALANCEYour wallet doesn't have enough for this call, so we didn't run it.no₹0
404RECORD_NOT_FOUNDThe source has no record for this ID.no₹0
429RATE_LIMITEDYou sent requests faster than your key's limit.yes₹0
503PROVIDER_UNAVAILABLEAll upstream sources for this check were down, even after fallback.yes₹0
504PROVIDER_TIMEOUTThe upstream source took too long to answer.yes₹0

₹1.00

GST by PAN · incl. GST · failed calls ₹0

Get early access