India reference-data lookups, as an API

IFSC, pincode, GSTIN and PAN — served over a plain HTTP JSON API. Free tier at 500 calls/month, no card required to start.

Endpoints

GET /v1/ifsc/{code} Bank, branch, address, MICR, and UPI/NEFT/RTGS/IMPS flags for an IFSC code. GET /v1/pincode/{pin}Beta Post offices, district and state for a 6-digit pincode. GET /v1/gstin/validate/{gstin} Format + checksum validation, decoded state and embedded PAN. GET /v1/pan/validate/{pan} Format validation and decoded entity type for a PAN.

Quick start

Every endpoint needs an API key, sent as Authorization: Bearer <key> or X-API-Key.

curl https://bharat-data-api-gateway.planbcreator365.workers.dev/v1/ifsc/HDFC0001234 \
  -H "X-API-Key: bda_live_<your key>"

{
  "ifsc": "HDFC0001234",
  "bank": "HDFC Bank",
  "branch": "TULSIANI CHAMBERS",
  "address": "101-104 TULSIANI CHAMBERS, NARIMAN POINT, MUMBAI",
  "micr": "400240003",
  "upi": true,
  "neft": true,
  "rtgs": true,
  "imps": true
}

Full request/response shapes, headers and status codes: see the API reference.

Be honest about what you're getting

GSTIN and PAN endpoints check format only. A valid: true result means the input matches the published GSTIN/PAN structure (and, for GSTIN, its checksum) — it does not confirm the number is real, active, or currently registered with any government system. Every response includes a formatOnly: true field and a plain-language note saying the same.

Pincode data is beta. The dataset is a community mirror of the data.gov.in All India Pincode file, not the official current export (which is unreachable at the time of writing). The mirror claims a 2019 vintage, but its GitHub repository's last commit is dated 2017-01-31, so the underlying data is no better evidenced than January 2017 — every response reports dataAsOf: "2017-01" accordingly. District names may predate district reorganizations since then (for example, Andhra Pradesh's 2022 split). We retry the official source monthly and will switch the moment it's reachable.

Pricing

Plans are per API key, metered monthly. Available on RapidAPI or direct.

Plan	Price (RapidAPI / direct)	Calls / month
Free	$0	500
Pro	$9 / ₹699	50,000
Ultra	$29 / ₹2,299	500,000
Mega	$99 / ₹7,999	5,000,000

Errors

Every error is { "error": { "code", "message", "docs" } } with the matching HTTP status. See the full error reference.