Skip to main content
GET
Search HTS Codes
Search HTS codes using full-text search, code prefix matching, or hierarchical filtering. Returns paginated results with optional clarification suggestions.

Parameters

Example Request

Example Response

Clarifications

When a search returns multiple classifications, the API includes a clarification object with suggestions to help refine your search. Business plans can also receive ai_context with AI-assisted guidance.

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., '8517' or '8517.12')

Maximum string length: 50
chapter
string

Filter by chapter (2 digits, e.g., '85')

Maximum string length: 10
heading
string

Filter by heading (4 digits, e.g., '8517')

Maximum string length: 10
subheading
string

Filter by subheading (6 digits, e.g., '851712')

Maximum string length: 10
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

HTS Code response with pagination

data
object[]
meta
object
clarification
object
ai_context
string

AI-assisted context (Business plans only)