Sibling Classification
====================

Get the hierarchical siblings of a given HSN code, including the current, previous, and next codes (if they exist).

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

.. code-block:: bash

   GET /hsn/{code}/siblings

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

.. code-block:: bash

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

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

.. code-block:: json

   {
     "data": {
       "siblings": [
         {
           "position": "current",
           "code": "01061100",
           "parent": "0106",
           "meta": {
             "desc": "Primates",
             "remarks": "Nil-rated for primates",
             "summary": "No summary available"
           }
         },
         {
           "position": "next",
           "code": "01061200",
           "parent": "0106",
           "meta": {
             "desc": "Whales, dolphins, porpoises, manatees, dugongs, seals",
             "remarks": "Nil-rated for marine mammals",
             "summary": "No summary available"
           }
         }
       ]
     }
   }

Field Reference
---------------

Siblings Array
^^^^^^^^^^^^^^

.. list-table::
   :header-rows: 1
   :widths: 20 50 30

   * - Field
     - Description
     - Example
   * - siblings[].position
     - Position of the sibling relative to the queried HSN code  
       (``previous``, ``current``, or ``next``)
     - ``current``
   * - siblings[].code
     - The HSN code for this sibling
     - ``01061100``
   * - siblings[].parent
     - The parent code that groups this HSN
     - ``0106``
   * - siblings[].meta.desc
     - Description of this sibling HSN
     - ``Primates``
   * - siblings[].meta.remarks
     - Remarks for this sibling classification
     - ``Nil-rated for primates``
   * - siblings[].meta.summary
     - Summary notes (may be ``No summary available`` if not provided)
     - ``No summary available``