{code}

Retrieve basic information and hierarchy details for an exact HSN code.

Request

Method: GET
Path: /search/hsn/{code}
Auth: X-API-Key: <your_key>

Path Parameters

code (string, required): Exact HSN code (e.g., 04041010)

Curl Example

curl --location 'https://api.taxlookup.fastgst.in/search/hsn/04041010' \
--header 'X-API-Key: ****'

Successful Response

{
  "success": true,
  "data": {
    "hsn_code": "04041010",
    "description": "Whey, Concentrated, Evaporated or Condensed, Liquid or Semi Solid",
    "hierarchy": {
      "chapter": {"level": "Chapter", "description": "Dairy Produce Birds Eggs Natural Honey Edible Products of Animal Origin Not Elsewhere Specified or Included"},
      "heading": {"level": "Heading", "description": "Yogurt Buttermilk Curdled Milk and Cream Kephir and Other Fermented or Acidified Milk and Cream Whether or Not Concentrated or Containing Added Sugar or Other Sweetening Matter or Flavoured or Containing Added Fruit Nuts or Cocoa"},
      "sub_heading": {"level": "Sub-Heading", "description": "Whey and Modified Whey Whether or Not Concentrated or Containing Added Sugar or Other Sweetening Matter"},
      "tariff_item": {"level": "Tariff Item", "description": "Whey, Concentrated, Evaporated or Condensed, Liquid or Semi Solid"}
    }
  },
  "meta": {"api_version": "v1", "timestamp": "2025-10-12", "request_id": "req_0HNG9G0COVSHF:00000001"}
}

Notes

Use GET /search/hsn to discover codes, then call this endpoint to fetch authoritative descriptions and hierarchy.

Errors

See API Conventions for common errors and shapes.