Tariff Lookup API

China's 2026 import & export duty rates, one lookup away

Send an HS code and an origin country; get the applicable duty rate the way China's customs rules actually resolve it — provisional beats MFN, agreement rates when lower, quota handling, ordinary-rate rules — plus the full statutory breakdown and page-level provenance from the official 2026 schedule.

9,471 national tariff lines

238,926 statutory rate facts

31 agreement / preference codes

Effective 2026-01-01

How it works

curl "https://chinadata.live/api/v1/tariffs?hs_code=02013000&origin_country=AU"
{
  "success": true,
  "results": [{
    "hs_code": "02013000",
    "applicable": { "basis": "agreement:AU", "rate_percent": 0, "display": "0%" },
    "breakdown": { "mfn": { "display": "12%" }, "preferential": [ ... ] },
    "conditions": ["Preferential rate under China-Australia FTA (AU) ..."],
    "page": 30, "source_sha256": "76af4db0..."
  }]
}

Free tier: 20 lookups per IP per day on /api/v1/tariffs. Paid plans call /api/v2/payg/tariffs with Authorization: Bearer <your key> — same payload, metered, never cached, with remaining credits echoed on every response.

Resolution follows the schedule's own rules: provisional beats MFN; agreement vs provisional → lower wins; special-preferential vs provisional → lower wins; in-quota volume uses the quota rate; ordinary-rate goods never get provisional rates; the provisional export rate overrides the statutory export duty.

Plans

Pay once, use for 90 days. One lookup = one credit, however many HS8 lines an HS6 expansion returns. Payment is via Stripe; your API key is emailed automatically after checkout.

Free

$0

20 lookups per IP per day. Full breakdowns and provenance on /api/v1/tariffs. No key required.

Start free

Starter

$6.90

1,000 lookups · 90 days

For evaluations and low-volume checks. Under one cent per lookup.

Pro

$139

10,000 lookups · 90 days

For logistics and compliance tooling. About 30% below comparable flat-rate tariff APIs.

Keys are delivered by email right after payment and are also provisioned for manual invoicing via the API access request if you prefer PO terms.

Frequently asked questions

Which schedule does the API serve?

The official《中华人民共和国进出口税则(2026)》(PRC Import and Export Tariff Schedule, effective 2026-01-01), parsed from the published PDF. Every response cites the schedule page and the source PDF SHA-256.

What does one lookup cover?

One HS code plus optional origin country and direction. An HS6 input expands to every HS8 national line under it (including ex exception lines) and still counts as one lookup.

Is the preferential rate guaranteed?

No. Agreement and special-preferential rates require valid rules-of-origin certification; responses always carry that caveat. Out-of-quota treatment follows Customs Law arts. 12-13 and is out of scope.

How is the free tier limited?

20 lookups per IP per UTC day on /api/v1/tariffs, with X-RateLimit headers. Paid plans use /api/v2/payg/tariffs with an API key and one credit per lookup, never cached.

API reference Parameters, response fields, and error contracts. Trade data Monthly China customs flows by country and HS product. Custom data pricing One-time CSV / Excel deliveries scoped to your codes. Enterprise access Higher volumes, invoicing, and custom scopes.
💬 Need custom data?