Search Products

Search HSN codes by product keywords using fuzzy matching.

Note

Once you get the HSN code, use the other endpoints to get tax rates, cess rates & meta information about the product

API Endpoint

GET /fuzzysearch/product?query={keyword}

Example Request

curl --location '<BASE_URL>/fuzzysearch/product?query=corn'

Example Response

[
    {
        "matchPercentage": "30.00%",
        "hsn": "1904",
        "option": "Prepared foods obtained by the swelling or roasting of cereals or cereal products (for example, corn flakes); cereals (other than maize (corn)) in grain form or in the form of flakes or other worked grains (except flour, groats and meal), pre-cooked, or otherwise prepared, not elsewhere specified or included",
        "matches": [
            {
                "hsn": "19041010",
                "option": "Corn flakes"
            },
            {
                "hsn": "19041020",
                "option": "Puffed rice, commonly known as murmura, mudi, pori or khoi"
            },
            {
                "hsn": "19041030",
                "option": "Bulgur wheat"
            },
            {
                "hsn": "19041090",
                "option": "Other"
            },
            {
                "hsn": "19042000",
                "option": "Prepared foods obtained from unroasted cereal flakes or from mixtures of unroasted cereal flakes and roasted cereal flakes or swelled cereals"
            },
            {
                "hsn": "19043000",
                "option": "Bulgur wheat"
            },
            {
                "hsn": "19049000",
                "option": "Other prepared cereals"
            }
        ]
    },
    {
        "matchPercentage": "20.00%",
        "hsn": "1005",
        "option": "Maize (corn)",
        "matches": [
            {
                "hsn": "10051000",
                "option": "Maize seed"
            },
            {
                "hsn": "10059000",
                "option": "Other maize"
            }
        ]
    }
]

Field Reference

Top-Level Fields

Field	Description	Example
matchPercentage	Percentage relevance of the search result to the query	30.00%
hsn	The top-level HSN code matched	1904
option	Description of the matched HSN code	Prepared foods obtained by the swelling or roasting of cereals ...
matches	List of sub-classifications (child HSN codes) under this match	[ { "hsn": "19041010", "option": "Corn flakes" }, ... ]

Matches Array

Field	Description	Example
matches[].hsn	Child HSN code under the parent result	19041010
matches[].option	Description of the child HSN code	Corn flakes