---
title: "As-of customs-tariff lookup across EU, US, UK and Japan"
method: GET
path: "/v1/tariff"
tags: ["Tariffs"]
---

# As-of customs-tariff lookup across EU, US, UK and Japan

`GET /v1/tariff`

## Request

- Base URL: `https://api.stackdata.io`
- URL: `https://api.stackdata.io/v1/tariff`
- Auth: one of:
  - none
  - API key in header `X-API-Key`

Which measures apply to a goods code, from an origin, on a date — duty
expressions **verbatim**, every measure carrying its legal citation
(EUR-Lex Official Journal / US HTS revision / UK statutory instrument on
legislation.gov.uk / Japan Customs edition). Not legal advice.

Vintage semantics per jurisdiction: `eu` monthly TARIC snapshots,
`us` HTS revision snapshots, `jp` schedule editions, `uk` live pass-through
of the HMRC API with native historical `as_of`. Jurisdiction-specific
honesty notes ride on every answer (e.g. US chapter-99 overlays — Section
301/232 — are served but not auto-joined to base rates). Empty answers are
free; the priced unit is the lookup (uk: the uncached upstream fetch).

## Query parameters

- `code` string, required
- `jurisdiction` 'eu' | 'us' | 'uk' | 'jp'
- `origin` string
- `date` string, date
- `direction` 'import' | 'export'

## Response `200`

Measures with duties, validity windows and citations; status `empty` when none match.

## Other responses

- `402`: x402 payment terms (anonymous over-quota).
- `422`: Malformed code / jurisdiction / date.

---

[API](https://skmtc.dev/stackdata/apis/stackdata-api.md) · [All operations](https://skmtc.dev/stackdata/apis/stackdata-api/llms.txt) · [OpenAPI document](https://skmtc.dev/stackdata/apis/stackdata-api/revisions/91358ae3f6e8?raw)