Trade Intelligence

HS Classification API

Available via API

Turn a product description into ranked Harmonized System candidates with confidence scores.

Beta · sample data

During the beta these results come from a sample reference dataset (tax rates, HS catalog, regulations, screening, sanctions and PEP lists), not the official sources. Use them to build and test your integration, not for customs declarations or compliance decisions. API responses carry x-tariffapis-data: sample.

What you get

Ranked candidates

Several headings with confidence, not a single guess.

Explainable

Each candidate carries the heading description it matched.

Human in the loop

Low-confidence results are flagged for broker review.

Endpoints

POST /api/v1/hs/classify Classify a product description

Authenticate with Authorization: Bearer tk_live_…. See the API reference.

Try it

curl -X POST https://tariffapis.com/api/v1/hs/classify \
  -H "Authorization: Bearer $TARIFFAPIS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"description": "stainless steel insulated water bottle, 750 ml", "limit": 3}'