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.

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:

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

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.

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

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

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

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