{code}

Retrieve basic information and hierarchy details for an exact HSN code.

Request

Method: GET
Path: /search/hsn/{code}
Auth: X-API-Key: <your_key>

Path Parameters

code (string, required): HSN code (6 or 8 digits)

Curl Example

curl --location 'https://api.taxlookup.fastgst.in/search/hsn/96020010' \
--header 'X-API-Key: ****'

Successful Response (8-digit HSN)

{
      "success": true,
      "data": {
              "hsn_code": "85431030",
              "schedule": "Schedule II",
              "description": "Synchrocyclotrons Synchrotrons",
              "hierarchy": {
                      "section": {
                              "code": "84-85",
                              "description": "XVI Machinery And Mechanical Appliances Electrical Equipment Parts And Accessories Thereof"
                      },
                      "chapter": {
                              "code": "85",
                              "description": "Electric Motors And Generators (excluding Generating Sets)."
                      },
                      "heading": {
                              "code": "8543",
                              "description": "General"
                      },
                      "sub_heading": {
                              "code": "854310",
                              "description": "Particle Accelerators"
                      },
                      "tariff_item": {
                              "code": "85431030",
                              "description": "Synchrocyclotrons Synchrotrons"
                      }
              }
      },
      "meta": {
              "api_version": "v1",
              "timestamp": "2025-12-01",
              "request_id": "req_0HNHH2HQ2I0G2:0000000A"
      }
}

Partial Content Response (6-digit HSN with multiple sub-codes)

{
      "success": true,
      "warning": "The specified HSN code has multiple tax rates within it. Give a specific 8 digit HSN code",
      "data": [
              {
                      "hsn_code": "85431010",
                      "description": "Particle Acceleratorsion Implanters For Doping Semi Conductor Materials"
              },
              {
                      "hsn_code": "85431020",
                      "description": "Vane Graff Cock-Croft Walton Accelerators"
              },
              {
                      "hsn_code": "85431030",
                      "description": "Synchrocyclotrons Synchrotrons"
              },
              {
                      "hsn_code": "85431090",
                      "description": "Other Including Cyclotrons"
              }
      ],
      "meta": {
              "api_version": "v1",
              "timestamp": "2025-12-01",
              "request_id": "req_0HNHH2HQ2I0G2:00000009"
      }
}

Notes

Use GET /search/hsn to discover codes, then call this endpoint to fetch authoritative descriptions and hierarchy.

Error Responses

Invalid HSN Code Format (400)

{
      "success": false,
      "error": {
              "code": "6/8_DIGIT_HSN_CODE_EXPECTED",
              "message": "Ensure HSN is either 6 digit (International WCO standard) or 8 digit (Indian Customs & GST) code",
              "suggestion": "Use search endpoint to find the HSN code if you're unsure"
      },
      "meta": {
              "api_version": "v1",
              "timestamp": "2025-12-01",
              "request_id": "req_0HNHH2HQ2I0G2:00000003"
      }
}

HSN Code Not Found (404)

{
      "success": false,
      "error": {
              "code": "HSN_NOT_FOUND",
              "message": "No HSN codes found for '123456'",
              "suggestion": null
      },
      "meta": {
              "api_version": "v1",
              "timestamp": "2025-12-01",
              "request_id": "req_0HNHH2HQ2I0G2:00000007"
      }
}

Notes

Use GET /search/hsn to discover codes, then call this endpoint to fetch authoritative descriptions and hierarchy.
For 6-digit HSN codes that have multiple 8-digit sub-codes, a 206 Partial Content response is returned with available options.
Use the specific 8-digit code from the partial response for tax rate queries.