HS Lookup API

ℹ️

Developer documentation for the HS Lookup API is available here.

The HS Lookup endpoint allows you to retrieve the full country-specific HS code for your product in a single query. It is available for all of our destination countries and leverages our product taoxnomy - meaning all duties and taxes are included in the response.

Key features

• Single, accurate match - HS Lookup always returns one best-fit HS code for the product you search.
• Full HS code - Results always include the full country-specific up-to-date HS code.
• All duties & taxes - Retrieve country-specific Most-Favoured Nation (MFN) duty rates, VAT, excise, and other applicable taxes and charges.
• Leverage for classification - If you are using our Landed Cost Calculator, you can use HS Lookup to retrieve the Dutify Classification ID to pre-classify your product catalog.

How HS Lookup works

Unlike Tariff Search, which returns an array of matches, HS Lookup provides a single match. It also returns more datapoints.

1. You query with:
   1. A full or partial HS code (minimum 2 digits),
   2. A product description, e.g. "men’s cotton t-shirt".
   3. Or both.
2. HS Lookup searches the product taxonomy, containing mapped product data, official tariff schedules, rulings, and notes to determine the closest match.
3. The API returns a single, country-specific HS code with:
   1. Product classification name
   2. Classification ID
   3. The MFN duty rate
   4. Sales tax rate
   5. Excise rate
   6. Additional tax rates and charges

Implementation notes

• Always a match: HS Lookup never returns multiple options - results are narrowed to the single best fit. A match will always be returned, even in the instance that there is no relevance (i.e. when very little input data is provided in the request).
• Country specificity: Each request is for a specific country, if you need data for multiple countries, you will need to make multiple requests.