Get Tax Rates
=====================

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


Important - "GST Types"
------------------------

When you search GST rate for a product using the API, you can expect the following GST types in JSON response. For most cases you'll see STANDARD, NIL_RATED, EXEMPT or CONDITIONAL as types.

.. list-table::
   :header-rows: 1
   :widths: 20 80

   * - GST Type
     - Full Description
   * - STANDARD
     - Standard GST rates as per GST schedule.
   * - ZERO_RATED
     - 0% GST applicable to exports and SEZ supplies; Input Tax Credit (ITC) allowed.
   * - EXEMPT
     - No GST due to exemption notification; ITC not allowed.
   * - NIL_RATED
     - 0% GST as per rate schedule; technically different from exempt.
   * - CONDITIONAL
     - GST applicable only under specific conditions (e.g., job work, thresholds).
   * - REVERSE_CHARGE
     - GST payable by recipient under Reverse Charge Mechanism (RCM).
   * - COMPOSITION
     - Fixed-rate GST for small taxpayers; no ITC or GST collection allowed.
   * - SPECIAL_RATE
     - Custom or concessional rates notified under specific government notifications.


Important - "Conditional GST Types"
------------------------------------

Let's say you got a CONDITIONAL GST type for given HSN Code. Now that means the same product can have different GST rates based on certain conditions. This means you will see multiple GST rates for the specified HSN code.
The below are the different conditions you can expect to see in the API response:

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

   * - Conditional Type
     - Full Description
   * - JOB_WORK
     - 1.5% GST for job work in jewelry/textile when done for a registered principal.  
       12% GST for generic job work.  
       Exempt if recipient is unregistered and covered under notifications.
   * - TURNOVER_BASED
     - No GST if supplier’s turnover is below ₹20L (services) or ₹40L (goods).  
       GST applies once the threshold is crossed, subject to state-specific rules.
   * - TYPE_OF_SUPPLY
     - GST exemption depends on whether the supply is intra-state or inter-state.  
       Example: Agricultural transport is exempt intra-state, but may attract GST inter-state.
   * - RECIPIENT_TYPE
     - Applies when GST liability shifts based on recipient.  
       Example: Services like legal/security fall under RCM for registered businesses,  
       but are exempt if provided to individuals.
   * - NOTIFICATION_BASED
     - Exemptions based on official GST notifications.  
       Examples: Charitable trusts, or SEZ supplies made under LUT without GST.
   * - PRODUCT_USAGE_BASED
     - GST varies by end use.  
       Example: UPS/inverter used standalone attracts full GST,  
       but integrated with solar systems may get concessional or zero GST.


.. caution::
   Please read the above documentation carefully to understand the different forms of GST rates you can expect from the API response.

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

.. code-block:: bash

   GET /hsn/{code}/gstrate

Example 1: Standard GST Rate
---------------

You're seeeing only one GST rate in the response because HSN Code 19041010 has a standard single GST rate.

.. code-block:: bash

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

.. code-block:: json

  {
      "data": {
          "hsn": "19041010",
          "gstType": "STANDARD",
          "gstTypeInfo": "Standard applicable slab rate.",
          "gstConditionType": null,
          "gstConditionTypeInfo": null,
          "taxes": [
              {
                  "rate": 5,
                  "displayText": "5%",
                  "option": "Corn flakes"
              }
          ]
      }
  }


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.``