HS Code & Import Duty API: UK Tariff and US HTS Rates

Use when: a cross-border e-commerce, customs or logistics agent needs a commodity code and import duty for a product: UK 10-digit commodity code with third-country duty, import VAT and the preferential rate for an origin country, plus US HTS general, special and column 2 rates.

Try this input

{"requests": [{"q": "ceramic coffee mug", "origin": "CN"}, {"code": "6109100010", "origin": "VN"}, {"q": "lithium ion battery", "markets": ["US"]}]}

Sample output (one item, shortened)

{"query": "6109100010", "origin": "VN",
 "uk": [{"code": "6109100010", "description": "T-shirts", "declarable": true, "uk_third_country_duty": "12.00%", "uk_vat": "0.00%",
         "uk_preferential": {"rate": "0.00%", "area": "CPTPP All Members", "note": "Needs proof of origin under the trade agreement or scheme."}}],
 "us": [{"hts": "6109.10.00", "description": "Of cotton", "general_rate": "16.5%", "special_rate": "Free (AU,BH,CL,...)", "column2_rate": "90%"}, "..."],
 "best_hs6": "610910", "error": null}

Each item is a code (4 to 10 digits) or a text query q, with optional origin (ISO country), markets (["UK","US"]) and limit. best_hs6 gives the 6-digit HS code shared by the UK and US results. Up to 500 items per run.

Pricing: pay per event, $0.003 per tariff lookup. Rows with errors are not charged.

Limits & failure modes

• Text search maps common product words (mug, laptop, smartphone, battery, t-shirt, shoes, chair and ~120 more, with material hints like ceramic/porcelain/cotton) to HS codes, then falls back to the UK Trade Tariff search. Unusual or vague descriptions can still give a loose match or none: check the description, or look up by code when you have one.
• Indicative only. Binding classification comes from HMRC (Advance Tariff Ruling) or US CBP. Extra duties (anti-dumping, quotas, US Section 301/IEEPA) are not included.
• Sources: UK Trade Tariff API (Open Government Licence v3.0) and USITC HTS (public domain).

Last tested: 29 Oct 2026.

Use from AI agents (MCP)

• Apify MCP server: add https://mcp.apify.com/?tools=tudorlane/hs-tariff-code to Claude, Cursor, ChatGPT, VS Code or any MCP client.
• REST: POST https://api.apify.com/v2/acts/tudorlane~hs-tariff-code/run-sync-get-dataset-items?token=YOUR_TOKEN with the input JSON.