Tariff Search API

ℹ️

Developer documentation for the Tariff Search API is available here.

The Tariff Search endpoint allows you to query an entire country tariff using a full or partial HS code and or a product description to return a list of relevant matches - the response includes the full HS code, tariff headings and duty rates for each match.

How Tariff Search works

Unlike HS Lookup, which always returns a single match, Tariff Search provides up to ten potential matches. Each match includes:

• The full HS code
• Chapter, heading, subheading descriptions
• The national tariff description
• The MFN duty rate

What you provide in the request

You can provide:

• A full or partial HS code (minimum 2 digits),
• A product description,
• Or both.

When both are provided:

• Relevance is first determined by the HS code.
• The product description is then used to refine the results.

Examples

• Valid Partial HS Code + Description
  • If you provide HS code 6204 and description "women’s casual green woven cotton suit", the search will look within Chapter 62 and Heading 04 to find the best matches.
• Invalid HS Code
  • If you provide HS code 6273, the system steps backward through the digits until a valid level is found (in this case, Chapter 62). Potential matches will then be filtered accordingly.
• Direct Match
  • If there is a single exact match for your input, only that match will be returned.

Response rules

• The response will include a maximum of 10 matches.
• Each match is ranked by relevance, based on how closely the description and/or HS code aligns with the official tariff schedule.
• Excise, sales tax and additional taxes are not included in the response for the Tariff Search endpoint.

⚠️

Tariff Search is currently only available for the United Kingdom and United States.