Reference Data

HS Code Lookup

Search and browse Harmonized System (HS 2022) commodity codes. Supports text search by product description, exact code lookup with ancestor chain, and section browsing. Covers 6,937 codes across 21 sections and 96 chapters.

get/api/hs

Request

  • Base URL: https://www.freightutils.com
  • URL: https://www.freightutils.com/api/hs
  • Auth: none declared

Query parameters

qstring

Case-insensitive search on descriptions and HS codes. Min 2 characters. When no HS 2022 description contains the words, the UK Trade Tariff search references (HMRC) are asked, and the codes they name come back with matched_via ("laptop" → 847130).

codestring

Exact HS code: 2–6 digits, written with or without dots or spaces (e.g. 847130, 8471.30, 0901).

sectionstring

Browse by section Roman numeral. Returns all chapters in that section.

Response

HS code data. Response shape varies by query mode.

OR
OR

Example response

{
  "query": "coffee",
  "results": [
    {
      "hscode": "0901",
      "description": "Coffee, whether or not roasted or decaffeinated",
      "level": 4,
      "parent": "09",
      "section": "II"
    }
  ],
  "count": 12,
  "matched_via": {
    "source": "UK Trade Tariff search references (HMRC)",
    "url": "https://www.trade-tariff.service.gov.uk/search?q=laptop",
    "matches": [
      {
        "tariff_code": "8471300000",
        "hscode": "847130"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.