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

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

Successful Response

{
  "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 API Conventions for common errors and shapes.