Metadata - By HSN

Get detailed information about the full lineage (section → chapter → heading → subheading) of a given HSN code.

API Endpoint

GET /hsn/{code}/meta

Example Request

curl --location '<BASE_URL>/hsn/01061100/meta'

Example Response

{
  "data": {
    "code": "01061100",
    "section": {
      "code": "I",
      "name": "Live animals; animal products",
      "desc": "Covers live animals and all products derived from animals.",
      "hierarchy": {
        "chapter": {
          "code": "01",
          "desc": "Live animals",
          "remarks": "Base chapter for live animals",
          "summary": "• Covers live animals under headings 0101–0106\n• Most live animals are nil-rated\n• Horses may have exceptions\n• No cess applicable across entries\n• Subcategories override chapter rates\n• GST varies only for certain horses\n• CBIC confirms nil-rating for most\n• Clean classification across mammals, birds, insects"
        },
        "heading": {
          "code": "0106",
          "desc": "Other live animals (mammals, birds, insects, reptiles)",
          "remarks": "Base heading; all subcategories nil-rated",
          "summary": "• Covers other live animals\n• All subcategories nil-rated\n• Includes primates, whales, insects\n• No cess applicable\n• CBIC confirms 0% GST\n• Broad classification\n• No conditional rates\n• Diverse animal types"
        },
        "subheading": {
          "code": "01061100",
          "desc": "Primates",
          "remarks": "Nil-rated for primates"
        }
      }
    }
  }
}

Field Reference

Section

Field	Description	Example
section.code	Section code (Roman numeral)	`I`
section.name	Section name	`Live animals; animal products`
section.desc	Section description	`Covers live animals and all products derived from animals.`

Chapter

Field	Description	Example
chapter.code	Chapter code	`01`
chapter.desc	Chapter description	`Live animals`
chapter.remarks	Additional notes on chapter	`Base chapter for live animals`
chapter.summary	Summary points	`• Covers live animals under headings 0101–0106 …`

Heading

Field	Description	Example
heading.code	Heading code	`0106`
heading.desc	Heading description	`Other live animals (mammals, birds, insects, reptiles)`
heading.remarks	Additional notes on heading	`Base heading; all subcategories nil-rated`
heading.summary	Summary points	`• Covers other live animals …`

Subheading

Field	Description	Example
subheading.code	Subheading code	`01061100`
subheading.desc	Subheading description	`Primates`
subheading.remarks	Additional notes on subheading	`Nil-rated for primates`