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

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

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

Response Format

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

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