hsn

Search HSN 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/hsn
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/hsn?query=fish' \
--header 'X-API-Key: *****'

Successful Response

{
      "success": true,
      "data": [
              {
                      "hierarchy": "0711",
                      "description": "Potatoes, Fresh Or Chilled.",
                      "match_score": 0.98,
                      "matches": [
                              {
                                      "hsn_code": "07113000",
                                      "description": "Vegetables Provisionally Preserved(For Example, By Sulphur Dioxide Gas,In Brine, In Sulphur Water Or In Otherpreservative Solutions), But Unsuitablein That State For Immediate Consumption Capers",
                                      "match_score": 0.98
                              },
                              {
                                      "hsn_code": "07119020",
                                      "description": "Assorted Canned Vegetables",
                                      "match_score": 0.95
                              }
                      ]
              },
              {
                      "hierarchy": "1209",
                      "description": "Soya Beans, Whether Or Not Broken.",
                      "match_score": 0.98,
                      "matches": []
              },
              {
                      "hierarchy": "1302",
                      "description": "Lac Natural Gums, Resins, Gum-Resins And Oleoresins (for Example, Balsams).",
                      "match_score": 0.98,
                      "matches": []
              },
              {
                      "hierarchy": "14",
                      "description": "Vegetable Materials Of A Kind Used Primarily For Plaiting (for Example, Bamboos, Rattans, Reeds, Rushes, Osier, Raffia, Cleaned, Bleached Or Dyed Cereal Straw, And Lime Bark).",
                      "match_score": 0.98,
                      "matches": []
              }
      ],
      "meta": {
              "api_version": "v1",
              "timestamp": "2025-12-01",
              "request_id": "req_0HNHH2HQ2I0G4:00000006"
      }
}

Notes

Advanced fuzzy search and local model tuned for semantic matching
Up to 6 matches per hierarchy group
match_score ranges from 0 to 1
Use this endpoint to identify candidate HSN codes before retrieving details or tax rates

Errors

See API Conventions for common errors and shapes.