Tax Rates - By HSN
=====================

Get detailed GST and tax information for a specific HSN code.

API Endpoint
------------

.. code-block:: bash

   GET /hsn/{code}/gstrate

Example Request
---------------

.. code-block:: bash

   curl --location '<BASE_URL>/hsn/35022000/gstrate'

Example Response
----------------

.. code-block:: json

   {
     "data": {
       "hsn": "35022000",
       "gstType": "STANDARD",
       "gstTypeInfo": "GST charged based on the applicable standard rate slab.",
       "gstConditionType": null,
       "gstConditionTypeInfo": null,
       "taxes": [
         {
           "rate": 18.00,
           "displayText": "18%",
           "option": "Milk albumin, including concentrates of two or more whey proteins",
           "paidBy": {
             "payer": "SUPPLIER",
             "reason": "GST will be collected and paid by the supplier."
           }
         }
       ]
     }
   }

Field Reference
---------------

Top-Level Fields
^^^^^^^^^^^^^^^^

.. list-table::
   :header-rows: 1
   :widths: 25 50 25

   * - Field
     - Description
     - Example
   * - data.hsn
     - The HSN code queried
     - ``35022000``
   * - data.gstType
     - Type of GST applied (e.g., STANDARD, NIL, EXEMPT)
     - ``STANDARD``
   * - data.gstTypeInfo
     - Explanation of the GST type
     - ``GST charged based on the applicable standard rate slab.``
   * - data.gstConditionType
     - Conditional GST type (if applicable, else null)
     - ``null``
   * - data.gstConditionTypeInfo
     - Additional info about the GST condition (if applicable)
     - ``null``

Taxes Array
^^^^^^^^^^^

.. list-table::
   :header-rows: 1
   :widths: 25 50 25

   * - Field
     - Description
     - Example
   * - taxes[].rate
     - Applicable GST rate (numeric value)
     - ``18.00``
   * - taxes[].displayText
     - Display format of the tax rate
     - ``18%``
   * - taxes[].option
     - Description of the specific tax option
     - ``Milk albumin, including concentrates of two or more whey proteins``
   * - taxes[].paidBy.payer
     - Who is responsible for paying the GST
     - ``SUPPLIER``
   * - taxes[].paidBy.reason
     - Explanation of why this payer is responsible
     - ``GST will be collected and paid by the supplier.``