GET /search/sac
================

Search SAC codes by keyword with hierarchical grouping. Returns up to the top 6 headings, each with up to 6 best-matching items.

Request
-------

- Method: ``GET``
- Path: ``/search/sac``
- Auth: ``X-API-Key: <your_key>``

Query Parameters
----------------

- ``query`` (string, required): Keyword or phrase (min 2 chars)

Curl Example
------------

.. code-block:: bash

  curl --location 'https://api.taxlookup.fastgst.in/search/sac?query=tex' \
  --header 'X-API-Key: *****'

Successful Response
-------------------

.. code-block:: json

  {
    "success": true,
    "data": [
      {
        "hierarchy": "9988",
        "description": "Manufacturing Services on Physical Inputs Goods Owned by Others",
        "match_score": 0.98,
        "matches": [
          { "sac_code": "998821", "description": "Textile Manufacturing Services", "match_score": 0.98 },
          { "sac_code": "998829", "description": "Textile Wearing Apparel and Leather Manufacturing Services Other Than Services by Way of Job Work Specified Above", "match_score": 0.98 }
        ]
      }
      // ... more groups ...
    ],
    "meta": {
      "api_version": "v1",
      "timestamp": "2025-10-12",
      "request_id": "req_0HNG9G0COVSMG:00000002"
    }
  }

Notes
-----

- Advanced fuzzy search with semantic matching
- Up to 6 matches per hierarchy group
- ``match_score`` ranges from 0 to 1
- Use this endpoint to identify candidate SAC codes before retrieving details or tax rates

Errors
------

See :doc:`../conventions` for common errors and shapes.