Skip to main content
GET
Search HS Codes
Search HS codes (6-digit international codes) using full-text search, code prefix matching, or ingredient-based search. Returns paginated results with optional clarification suggestions.

Parameters

Example Request

Example Response

The ingredients parameter allows you to search for codes by listing product ingredients. This is particularly useful for food products where the same ingredients can appear at different processing levels (raw, milled, prepared). When ingredient searches span multiple processing levels, the API provides clarification suggestions to help you choose the correct classification.

Authorizations

Authorization
string
header
required

API key as Bearer token. Format: Bearer your_hts_api_key

Query Parameters

q
string

Full-text search query

Maximum string length: 500
code
string

Exact or prefix code match (e.g., '1101' or '1101.00')

Maximum string length: 50
ingredients
string

Comma-separated list of ingredients (e.g., 'wheat,flour')

Maximum string length: 500
page
integer
default:1

Page number (default: 1)

Required range: x >= 1
limit
integer
default:25

Results per page (max: 100, default: 25)

Required range: 1 <= x <= 100

Response

HS Code response with pagination

data
object[]
meta
object
clarification
object
ai_context
string

AI-assisted context (Business plans only)