ClassifyHQ API Documentation

Free REST API for Harmonized System tariff code data. No authentication required.

No auth required

JSON responses

100 req/min rate limit

Base URL

https://classifyhq.ai/api

GET /api/sections

List all 21 HS sections with their chapter ranges.

Example Request

curl https://classifyhq.ai/api/sections

Example Response

{
  "I": {
    "roman": "I",
    "name": "Live Animals; Animal Products",
    "chapter_range": [1, 5],
    "chapters": [
      {"code": "01", "description": "Live animals", "level": "chapter"}
    ]
  }
}

GET /api/sections/{section}/chapters

List all chapters within a section.

Parameters

section string Roman numeral (e.g. XI, IV)

Example Request

curl https://classifyhq.ai/api/sections/XI/chapters

Example Response

[
  {"code": "50", "description": "Silk", "level": "chapter"},
  {"code": "51", "description": "Wool, fine or coarse animal hair...", "level": "chapter"}
]

GET /api/chapters/{code}/headings

List all 4-digit headings within a chapter.

Parameters

code string 2-digit chapter code (e.g. 51)

Example Request

curl https://classifyhq.ai/api/chapters/51/headings

Example Response

[
  {"code": "5101", "description": "Wool, not carded or combed", "level": "heading"},
  {"code": "5102", "description": "Fine or coarse animal hair", "level": "heading"}
]

GET /api/headings/{code}/subheadings

List all 6-digit subheadings under a heading.

Parameters

code string 4-digit heading code (e.g. 5101)

Example Request

curl https://classifyhq.ai/api/headings/5101/subheadings

Example Response

[
  {"code": "510111", "description": "Greasy shorn wool", "level": "subheading"},
  {"code": "510119", "description": "Other greasy wool", "level": "subheading"}
]

GET /api/subheadings/{code}

Get details for a 6-digit HS subheading, including all country-specific tariff codes.

Parameters

code string 6-digit HS code (e.g. 510111)

Example Request

curl https://classifyhq.ai/api/subheadings/510111

Example Response

{
  "code": "510111",
  "description": "Greasy shorn wool",
  "level": "subheading",
  "countries": {
    "US": [{"code": "5101110020", "description": "...", "rate": "Free"}],
    "EU": [{"code": "5101110000", "description": "...", "rate": "0%"}],
    "CA": [],
    "NO": []
  }
}

GET /api/countries/{country}/{code}

Get a specific country tariff code entry.

Parameters

country string Country code: us, eu, ca, or no

code string Country-specific tariff code

Example Request

curl https://classifyhq.ai/api/countries/us/5101110020

Example Response

{
  "code": "5101110020",
  "description": "Greasy shorn wool, Merino",
  "parent": "510111",
  "rate": "Free",
  "unit": "kg"
}

GET /api/search

Search across all HS codes by code number or keyword description.

Parameters

q string Search query (min 2 characters)

limit integer Max results (default 50)

Example Request

curl "https://classifyhq.ai/api/search?q=wool&limit=5"

Example Response

[
  {"code": "5101", "description": "Wool, not carded or combed", "level": "heading"},
  {"code": "510111", "description": "Greasy shorn wool", "level": "subheading"}
]