GST Verification API

Authentication

Every request must include an x-api-key header with a key generated from your API access page. Keys are shown once at creation and stored only as a hash — treat them like passwords and keep them server-side.

curl -H "x-api-key: YOUR_API_KEY" \
  https://www.checkyourgst.com/api/public/v1/gstin/27AAACT2727Q1ZW

GET /api/public/v1/gstin/{gstin}

Returns registration details for a single GSTIN. data_mode tells you whether the answer came from a live provider call, our cache, or demo data.

{
  "success": true,
  "data_mode": "LIVE",
  "verified_at": "2026-01-14T09:12:44.000Z",
  "record": {
    "gstin": "27AAACT2727Q1ZW",
    "legal_name": "EXAMPLE TRADERS PRIVATE LIMITED",
    "trade_name": "Example Traders",
    "status": "Active",
    "taxpayer_type": "Regular",
    "constitution": "Private Limited Company",
    "registration_date": "2017-07-01",
    "state": "Maharashtra"
  },
  "correlation_id": "req_9f2c1a"
}

Quota headers X-RateLimit-Limit and X-RateLimit-Remaining are returned on every authenticated response.

Code samples

const res = await fetch(
  "https://www.checkyourgst.com/api/public/v1/gstin/27AAACT2727Q1ZW",
  { headers: { "x-api-key": process.env.GST_API_KEY } }
);
const body = await res.json();
if (!body.success) throw new Error(body.error.code);
console.log(body.record.legal_name, body.record.status);

import os, requests

res = requests.get(
    "https://www.checkyourgst.com/api/public/v1/gstin/27AAACT2727Q1ZW",
    headers={"x-api-key": os.environ["GST_API_KEY"]},
    timeout=15,
)
body = res.json()
print(body["record"] if body["success"] else body["error"])

Error codes

Every response carries a correlation_id. Include it when contacting support so we can trace the exact request.