HSN Code Lookup

Business
POST /api/v1/gst/hsn-code Bearer

HSN Code Lookup API — Validate an HSN code (goods) or SAC code (services) and get what the code actually covers: its official tariff description, the chapter it sits under, the applicable GST rate, the rate-revision history, the cess note, and the date each revision took effect. Accepts 2, 4, 6 or 8-digit HSN codes and 6-digit SAC codes, and reports which schedule the code came from in code_type. Rates come back twice — in the schedule's own notation in gst_rate ("5/12/18") and as a numeric list in gst_rate_percent ([5, 12, 18]) so they can be compared without parsing — and every effective date is returned as an ISO date, most recent revision first. Use it to check an HSN code and its GST rate before raising an invoice, validate the codes a supplier put on an incoming purchase invoice, and keep a product or service catalogue tax-correct.

Availability

🗺 Country-specific

India

What HSN Code Lookup Is Used For

Invoice and e-invoice validation

Confirm the HSN or SAC on an invoice line exists and carries the rate you charged, before the invoice is filed.

Product catalogue tax mapping

Attach a verified code and GST rate to every SKU so billing, e-invoicing and GSTR-1 all agree.

Purchase invoice checks

Validate the codes a supplier applied on an incoming invoice rather than accepting the rate they charged.

Rate revision awareness

effective_dates shows when each revision took effect, so a historic rate is never mistaken for the current one.

Quick Start

1. Copy your API key from Dashboard → API Keys
2. Send a POST request to /api/v1/gst/hsn-code
3. Pass the key as Authorization: Bearer <key>
4. Read the result from the data object in the JSON response

cURL

curl -X POST https://app.way2api.com/api/v1/gst/hsn-code \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hsn_code":"998319"}'
🚀 Send Request
✓ Key saved

🔑 Remember API Key

One-click convenience for testing & troubleshooting — no account needed.

1

What it doesSaves your API key in this browser only using localStorage. Next time you open a docs page, the Try It panel is pre-filled automatically.

2

Auto-updatesIf you type a different key into any Try It field, the saved key is replaced instantly — only the most recent key is ever stored.

3

Uncheck to forgetUnchecking “Remember API Key” immediately deletes the stored key and clears the field. While unchecked, nothing is saved even if you type a new key.

4

Re-check to save againChecking the box again saves whatever key is currently in the Try It field.

⚠ Security note: Your key is stored only in your browser and is never sent to any server except as part of the actual API call you send. Do not use this feature on shared or public computers.

More on this API

Request Endpoint, authentication headers, every request parameter with its type, and a sample request body. Response The full success response payload, field by field. Error Codes HTTP status codes, error payload shape, and how to handle failures. Code Examples Ready-to-run examples in cURL, PHP, JavaScript and Python. Rate Limits Per-minute and per-day request limits, and what happens on breach. AI Agent / LLM The whole endpoint as one Markdown brief — paste into Claude, Cursor, Copilot or ChatGPT.