Tax Rates - By HSN

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

API Endpoint

GET /hsn/{code}/gstrate

Example Request

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

Example Response

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

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