GET /search/hsn/{code}/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
------------

.. code-block:: bash

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

Successful Response
-------------------

.. code-block:: json

  {
    "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
------------

.. code-block:: json

  {
    "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 :doc:`../conventions` for common errors and shapes.