Get Cess Rates
======================

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

.. tip::
   You can use this endpoint to get the Cess rate for a specific HSN code. Please read the documentation carefully to understand different forms of Cess rates.


What is HSN Cess Rate?
----------------------

HSN cess rate provides the additional cess rates applicable to specific HSN codes, including:
- National Calamity Contingent Duty (NCCD)
- Road and Infrastructure CESS
- Health and Education CESS
- Other special cess rates

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

.. code-block:: bash

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

Parameters
----------

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

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

.. code-block:: bash

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

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

.. code-block:: json

   {
     "status": "success",
     "hsn_code": "123456",
     "description": "Sample HSN description",
     "cess_rates": {
       "nccd_rate": "1%",
       "road_cess_rate": "0%",
       "health_cess_rate": "0%",
       "total_cess_rate": "1%",
       "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"
   }