Get HSN Cess Rate

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

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

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

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

Response Format

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

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