HS Code Lookup API
HS code lookup API, no key: product keyword to ranked HS / commodity codes, and any code to its full description chain, import duty (third-country), VAT, preferential rate for an origin country, quotas, anti-dumping and other measures for the UK tariff and the EU Common Customs Tariff. Code validation, non-declarable codes return their declarable children, bulk 50 lookups. Official HMRC data. Usable from AI agents via MCP.
Example request
curl -X POST https://radarbg.com/v1/hs-code-tariff-lookup \
-H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
-d '{"mode": "search", "q": "red wine", "market": "UK", "limit": 10}'
Answer: {"ok": true, "count": N, "items": [...], "usage": {...}}. Failed calls are not counted.
Inputs
| Field | Type | Description |
|---|---|---|
mode | string | search = keyword to ranked HS/commodity codes; code = full details of one code (duty, VAT, origin rate, measures, or declarable children); validate = check that codes exist and are declarable; bulk = up to 50 queries in one call. |
q | string | search mode: product words in English, e.g. cotton t-shirt, lithium battery, roasted coffee. |
code | string | code mode: HS / commodity code with 2, 4, 6, 8 or 10 digits; dots and spaces are ignored, e.g. 6109.10 or 6109100010. |
codes | array | validate mode: up to 100 codes. |
market | string | UK = UK Global Tariff (default); EU = EU Common Customs Tariff as published by the UK Trade Tariff Northern Ireland (XI) service. |
origin | string | ISO 2-letter country of origin, e.g. CN, VN, US. code mode returns the preferential rate and the duty that applies to this origin. |
queries | array | bulk mode: up to 50 objects, each one an input of another mode, e.g. {"mode":"code","code":"8517130000","origin":"VN"}. A failing query returns an error row; the others still answer. |
limit | integer | search mode: 1-50, default 10. |
onlyNew | boolean | Return only rows not returned before for the same Monitor ID. Schedule the run to get changes only. |
monitorId | string | Name of this monitor; each ID keeps its own memory of rows already returned. |
Price
Included in every plan: 100 calls a month free, then from €9 a month for 3,000 calls across all APIs.