Get HSN Tax Rate
================

This section explains how to retrieve tax rates for HSN codes.

What is HSN Tax Rate?
---------------------

HSN tax rate provides the applicable GST rate for a specific HSN code, including:
- Basic GST rate
- Any additional cess rates
- Special rates for specific categories

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

.. code-block:: bash

   GET /api/v1/hsn/{hsn_code}/tax-rate

Parameters
----------

- **hsn_code** (path): The HSN code to get tax rate for
- **date** (query, optional): Effective date for tax rate (default: current date)

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

.. code-block:: bash

   GET /api/v1/hsn/123456/tax-rate?date=2024-01-01

Response Format
--------------

.. code-block:: json

   {
     "status": "success",
     "hsn_code": "123456",
     "description": "Sample HSN description",
     "tax_rates": {
       "gst_rate": "18%",
       "cgst_rate": "9%",
       "sgst_rate": "9%",
       "igst_rate": "18%",
       "cess_rate": "0%",
       "effective_date": "2024-01-01"
     }
   }

Error Response
-------------

.. code-block:: json

   {
     "status": "error",
     "error": "HSN code not found",
     "message": "The specified HSN code does not exist in our database"
   }