Product Hierarchy
=========================

Get detailed information about the full hierarchy of a given HSN code.

.. tip::
   Use this endpoint to get information about the lineage of the HSN code (section → chapter → heading → subheading)

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

.. code-block:: bash

   GET /hsn/{code}/meta

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

.. code-block:: bash

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

Example Response
----------------

.. code-block:: json

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

.. list-table::
   :header-rows: 1
   :widths: 25 50 25

   * - 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
^^^^^^^

.. list-table::
   :header-rows: 1
   :widths: 25 50 25

   * - 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
^^^^^^^

.. list-table::
   :header-rows: 1
   :widths: 25 50 25

   * - 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
^^^^^^^^^^

.. list-table::
   :header-rows: 1
   :widths: 25 50 25

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