Get HSN Hierarchy
=================

This section explains how to retrieve the hierarchical structure of HSN codes.

What is HSN Hierarchy?
----------------------

HSN hierarchy shows the classification structure of goods, organized in levels:
- **Chapter** (2 digits): Broad category of goods
- **Heading** (4 digits): Specific group within chapter
- **Sub-heading** (6 digits): Detailed classification
- **Tariff item** (8 digits): Most specific classification

Hierarchy Levels
---------------

**Chapter Level (XX000000)**
- 01: Live animals
- 02: Meat and edible meat offal
- 03: Fish and crustaceans

**Heading Level (XXXX0000)**
- 0101: Live horses, asses, mules and hinnies
- 0102: Live bovine animals
- 0103: Live swine

**Sub-heading Level (XXXXXX00)**
- 010110: Pure-bred breeding horses
- 010120: Other horses
- 010130: Asses

API Endpoint
-----------

.. code-block:: bash

   GET /api/v1/hsn/{hsn_code}/hierarchy

Parameters
----------

- **hsn_code** (path): The HSN code to get hierarchy for
- **level** (query, optional): Hierarchy level to return (chapter, heading, sub-heading, all)

Example Request
--------------

.. code-block:: bash

   GET /api/v1/hsn/010110/hierarchy?level=all

Response Format
--------------

.. code-block:: json

   {
     "status": "success",
     "hsn_code": "010110",
     "hierarchy": {
       "chapter": {
         "code": "01",
         "description": "Live animals"
       },
       "heading": {
         "code": "0101",
         "description": "Live horses, asses, mules and hinnies"
       },
       "sub_heading": {
         "code": "010110",
         "description": "Pure-bred breeding horses"
       }
     }
   }