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

Skip to content
APIserver.in

GST Verify

Confirm a GSTIN is real, active and belongs to who they say.

POST/v1/gst/verify

₹0.75

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

Need this plus more? Add it to a Business360 call →GST profile is a Business360 module. Combine it with others and pay only for what succeeds, capped at ₹10.00.

What it does

Validates the GSTIN locally (format, state code, embedded PAN, checksum) before touching a source, then returns the registered legal name, trade name, status, registration date, taxpayer type and principal address.

Input
GSTIN
Output
Legal & trade name, status, registration date, type, address

Use cases

  • Invoice and ITC validation
  • Vendor master cleanup
  • Checkout B2B GST capture

Request

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

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/verify",
    headers={
        "Authorization": f"Bearer {os.getenv('APISERVER_KEY', 'as_test_YOUR_KEY')}",
    },
    json={
        "gstin": "29AAJCK4821M1Z1",
    },
    timeout=10,
)
body = res.json()
print(body["meta"]["charged"], body["meta"]["amount_inr"])
<?php
$ch = curl_init('https://api.apiserver.in/v1/gst/verify');
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([
        'gstin' => '29AAJCK4821M1Z1',
    ]),
]);
$body = json_decode(curl_exec($ch), true);
echo $body['meta']['charged'] ? 'charged' : 'not charged';
Request body fields
FieldTypeDescription
gstinrequiredstring15-character GSTIN. Validated locally (state code, embedded PAN, mod-36 checksum) before any source is called.

Response

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

{  : true,  : "as_req_01J9X2K7R8M4V6T2Q9W3E5Y1ZB",  : "gst.verify",  : "2026-10-01",  : {    : "29AAJCK4821M1Z1",    : "KAVERI TEXTILES PRIVATE LIMITED",    : "Kaveri Textiles",    : "Active",    : "2017-07-01",    : null,    : "Regular",    : "Private Limited Company",    : "Karnataka",    : "29",    : "AAJCK4821M",    : {      : "No. 14, 3rd Cross, Phase II",      : "Peenya Industrial Area",      : "Bengaluru",      : "Bengaluru Urban",      : "Karnataka",      : "560058"    },    : [      "Manufacturing",      "Wholesale Business"    ],    : true  },  : {    : true,    : 0.75,    : 284,    : "live",    : 1,    : "2026-10-03T09:12:00+05:30",    : "live"  }}

Field dictionary — data

Response data fields
FieldTypeDescription
gstinstringThe GSTIN, normalised
legal_namestringLegal name of business as registered
trade_namestringTrade name, if different from legal name
status"Active" | "Cancelled" | "Suspended"Current registration status
registration_datestringEffective date of registration (YYYY-MM-DD)
cancellation_datestring | nullDate of cancellation, if cancelled
taxpayer_type"Regular" | "Composition"Taxpayer type
constitutionstringConstitution of business, e.g. Private Limited Company
statestringState of registration
state_codestringTwo-digit GST state code
panstringPAN embedded in the GSTIN
principal_placeobjectPrincipal place of business
↳line1string—
↳localitystring—
↳citystring—
↳districtstring—
↳statestring—
↳pincodestring6-digit PIN code
nature_of_businessstring[]Declared nature of business activities
einvoice_enabledbooleanWhether e-invoicing applies

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

₹0.75

GST Verify · incl. GST · failed calls ₹0

Get early access