Business · Live
HSN Code Lookup API
Resolve an HSN code to its official description.
What the HSN Code Lookup API does
Look up the official description for an HSN code straight from the government master, rather than maintaining a copy that drifts out of date. Useful wherever a product catalogue has to carry a defensible HSN classification. Calls carry your own GST portal API credentials (GSTIN, username and password), so filings are made as you, on your own registration. We never file on our own account.
Popular use cases
- →Validating HSN codes in product and invoice masters
- →Catalogue onboarding for marketplaces and B2B commerce
- →Reducing invoice rejections caused by wrong classification
curl -X POST https://apisathi.in/gw/v1/ewb-get-hsn-v1/ \
-H "X-API-Key: live_xxx" \
-H "Content-Type: application/json" \
-d '{ "gstin": "23BEFPJ5660F2ZP", "username": "your_portal_user", "password": "•••", "query_string": "hsncode=8471" }'{
"success": true,
"data": { "hsnCode": "8471", "hsnDesc": "Automatic data processing machines" }
}Response fields returned by the HSN Code Lookup API
| Field | Example |
|---|---|
| success | true |
| data.hsnCode | 8471 |
| data.hsnDesc | Automatic data processing machines |
Every field, error code and the full schema are in the HSN Code Lookup API reference.
Call the HSN Code Lookup API from Node.js or Python
const res = await fetch('https://apisathi.in/gw/v1/ewb-get-hsn-v1/', {
method: 'POST',
headers: { 'X-API-Key': process.env.APISATHI_KEY, 'Content-Type': 'application/json' },
body: JSON.stringify({"gstin":"23BEFPJ5660F2ZP","username":"your_portal_user","password":"•••","query_string":"hsncode=8471"}),
});
const data = await res.json();import os, requests
res = requests.post(
"https://apisathi.in/gw/v1/ewb-get-hsn-v1/",
headers={"X-API-Key": os.environ["APISATHI_KEY"]},
json={"gstin":"23BEFPJ5660F2ZP","username":"your_portal_user","password":"•••","query_string":"hsncode=8471"},
timeout=30,
)
data = res.json()HSN Code Lookup API pricing
- → From ₹3 per successful call + 18% GST
- → Prepaid wallet from ₹200; no monthly fee, no minimum volume
- → Failed or timed-out calls are not charged
- → Bonus credit on recharges of ₹1,000 and above; GST invoice on every recharge
Start in four steps
- Create a free account — about a minute.
- Call the HSN Code Lookup API with your TEST key in the sandbox, free.
- Recharge the wallet (UPI, card or netbanking) from ₹200.
- Switch to your LIVE key — the same key works for every API.
Frequently asked questions
Why not keep my own HSN table?
You can, but the master changes and a stale table produces invoices that are rejected or classified wrongly. This reads the live government master.
Does this need portal credentials too?
Yes — it is served through the same GST gateway, so the same API user applies.
How much does the HSN Code Lookup API cost?
The HSN Code Lookup API on API Sathi starts at ₹3 per successful call plus 18% GST, paid from a prepaid wallet. There is no monthly fee or minimum volume, and recharges of ₹1,000 or more earn bonus credit. Live prices for every API are on the pricing page.
Can I test the HSN Code Lookup API for free?
Yes. Every account gets a TEST key that calls the HSN Code Lookup API in the sandbox at no cost and returns realistic sample responses, so you can finish your integration before adding money to the wallet.
Am I charged if a HSN Code Lookup API call fails?
No. You pay only for successful calls. If the source is unavailable, times out or rejects the request, the amount held for that call is released straight back to your wallet.
How do I get a HSN Code Lookup API key?
Sign up at apisathi.in — it takes about a minute — and create a key under API Keys. Use the TEST key in the sandbox, then recharge from ₹200 and switch to a LIVE key. The same key works for every API on API Sathi.
Related APIs
Udyam Verification API
Confirm MSME status and pull the full Udyam record.
From ₹15/call
GST Verification API
Validate any GSTIN and fetch taxpayer details in one API call.
From ₹1.20/call
Company / CIN Verification API
Resolve companies, CINs, PANs and directors from the MCA graph.
From ₹3.60/call
E-Way Bill API
Generate an e-way bill for any consignment in a single API call.
From ₹3/call
E-Invoice API (IRN Generation)
Register an invoice and get its IRN, signed QR and acknowledgement.
From ₹3/call
E-Invoice Cancellation API
Cancel a registered IRN within the window the portal allows.
From ₹3/call
Start using the HSN Code Lookup API today
Sign up, recharge a prepaid wallet and generate a key in minutes. Lowest price guaranteed, no volume commitment.