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": "9985",
                      "description": "Support Services",
                      "match_score": 0.98,
                      "matches": [
                              {
                                      "sac_code": "998594",
                                      "description": "Combined office administrative services",
                                      "match_score": 0.98
                              },
                              {
                                      "sac_code": "998552",
                                      "description": "Reservation services for accommodation/cruises/tours",
                                      "match_score": 0.9
                              }
                      ]
              },
              {
                      "hierarchy": "9988",
                      "description": "Manufacturing Services on Physical Inputs Goods Owned by Others",
                      "match_score": 0.98,
                      "matches": [
                              {
                                      "sac_code": "998874",
                                      "description": "Computer electronic and optical product manufacturing services",
                                      "match_score": 0.98
                              }
                      ]
              }
      ],
      "meta": {
              "api_version": "v1",
              "timestamp": "2025-12-01",
              "request_id": "req_0HNHH2HQ2I0G2:00000018"
      }
}

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.