taxes

Retrieve GST tax rates for an HSN code, including CGST/SGST/IGST breakdown and cess details if applicable.

Request

Method: GET
Path: /search/hsn/{code}/taxes
Auth: X-API-Key: <your_key>

Path Parameters

code (string, required): Exact HSN code (e.g., 04041010)

Curl Example

curl --location 'https://api.taxlookup.fastgst.in/search/hsn/04041010/taxes' \
--header 'X-API-Key: *****'

Successful Response

{
  "success": true,
  "data": {
    "gst_rate": 5.00,
    "cess_breakdown": "Cess Not Applicable",
    "gst_breakdown": { "cgst": 2.50, "sgst": 2.50, "igst": 5.00 },
    "is_exempted": false,
    "exemption_status": "Taxable",
    "broad_categeory": "Section I. Animals and Animal Products",
    "last_updated": "2025-10-12",
    "source": "gstin.gov.in"
  },
  "meta": { "api_version": "v1", "timestamp": "2025-10-12", "request_id": "req_0HNG9G0COVSIB:00000001" }
}

Cess Example

{
  "success": true,
  "data": {
    "gst_rate": 18.00,
    "cess_breakdown": "Rs. 400 per tonne",
    "gst_breakdown": { "cgst": 9.00, "sgst": 9.00, "igst": 18.00 },
    "is_exempted": false,
    "exemption_status": "Taxable",
    "broad_categeory": "Section V. Minerals",
    "last_updated": "2025-10-12",
    "source": "gstin.gov.in"
  },
  "meta": { "api_version": "v1", "timestamp": "2025-10-12", "request_id": "req_0HNG9G0COVSMG:00000001" }
}

Notes

Returns clear gst_breakdown for CGST/SGST/IGST and readable cess_breakdown when applicable
Includes is_exempted, exemption_status, broad category, last_updated and source
We leverage AI-assisted parsing to normalize cess information to a developer-friendly format

Updates & Coverage

We strive to reflect policy changes following the 56th GST Council meeting (3 Sep 2025) and CBIC notifications (17 Sep 2025), with most rules effective 22 Sep 2025. Our automation and manual QA monitor for changes and apply updates swiftly; minor delays can occur.

Errors

See API Conventions for common errors and shapes.