Business API

HSN Code Lookup

Validate an HSN code (goods) or SAC code (services) and get what the code actually covers: its official tariff description, the chapter i…

HSN Code Lookup
POST

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.

  • Coverage: India
  • Real-time business lookup
  • Structured JSON response
  • POST request with Bearer auth
Get API Key — Free View Full Docs
Endpoint
POST
https://app.way2api.com/api/v1/gst/hsn-code

Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

Request Parameters
Parameter Type Required Description
hsn_code string Yes HSN code for goods (2, 4, 6 or 8 digits) or SAC code for services (6 digits, beginning 99). Digits only.
Request Example
<?php $ch = curl_init(); curl_setopt_array($ch, [ CURLOPT_URL => "https://app.way2api.com/api/v1/gst/hsn-code", CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_HTTPHEADER => [ "Authorization: Bearer YOUR_API_KEY", "Content-Type: application/json" ], CURLOPT_POSTFIELDS => json_encode([ "hsn_code" => "998319" ]) ]); $response = curl_exec($ch); $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); $data = json_decode($response, true); print_r($data);
const response = await fetch("https://app.way2api.com/api/v1/gst/hsn-code", { method: "POST", headers: { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, body: JSON.stringify({ "hsn_code": "998319" }) }); if (!response.ok) { throw new Error(`HTTP error: ${response.status}`); } const data = await response.json(); console.log(data);
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"}'
$.ajax({ url: "https://app.way2api.com/api/v1/gst/hsn-code", type: "POST", contentType: "application/json", headers: { "Authorization": "Bearer YOUR_API_KEY" }, data: JSON.stringify({ "hsn_code": "998319" }), success: function(data) { console.log(data); }, error: function(xhr) { console.error(xhr.responseJSON); } });
const { data } = await axios.post( "https://app.way2api.com/api/v1/gst/hsn-code", {"hsn_code":"998319"}, { headers: { "Authorization": "Bearer YOUR_API_KEY" } } ); console.log(data);
import requests response = requests.post( "https://app.way2api.com/api/v1/gst/hsn-code", headers={ "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, json={ "hsn_code": "998319" } ) print(response.status_code) print(response.json())
Response Example
200 OK Success Response 
{
    "success": true,
    "message": "",
    "data": {
        "order_id": "W2A1739512345abcdef01",
        "result": {
            "hsn_code": "998319",
            "code_type": "SAC",
            "description": "OTHER INFORMATION TECHNOLOGY SERVICES N.E.C",
            "chapter_number": 99,
            "chapter_name": "Services",
            "gst_rate": "5/12/18",
            "gst_rate_percent": [
                5,
                12,
                18
            ],
            "rate_revision": "12% 5% 18%",
            "effective_date": "2019-10-01",
            "effective_dates": [
                "2019-10-01",
                "2017-07-01"
            ],
            "cess": "Nil Provided that Director (Sports), Ministry of Youth Affairs and Sports certifies that the services are directly or indirectly related to any of the events under FIFA U-17 Women's World Cup 2020."
        }
    }
}
4xx Error Response 
{
    "success": false,
    "message": "No HSN or SAC record was found for the code provided.",
    "data": {
        "order_id": "W2A1739512345abcdef01",
        "error_code": "NO_RECORD",
        "result": {
            "hsn_code": "9999999",
            "code_type": "",
            "description": "",
            "chapter_number": 0,
            "chapter_name": "",
            "gst_rate": "",
            "gst_rate_percent": [],
            "rate_revision": "",
            "effective_date": null,
            "effective_dates": [],
            "cess": ""
        }
    }
}
Common Response Codes
Code Meaning
200 OK — Request successful
400 Bad Request — Missing or invalid parameters
401 Unauthorized — Invalid or missing API key
429 Too Many Requests — Rate limit exceeded
500 Server Error — Try again later
Ready to integrate?

Start with free trial API calls. No credit card required.

Get API Key — Free Browse All APIs
Way2API Way2API
Contact Way2API

Login