One lookup, itemized duty context

Tariff Rate API

Submit an HTS code and origin to inspect the base duty, additional tariff layers, warnings, and source context in one lookup. Check the completion status before treating an estimate as a total.

What does the tariff API return?

Give the REST lookup an HTS code and country of origin, with an optional assessment date. It returns an itemized duty stack alongside an estimated total, calculation status, warnings, and source context. If facts remain unresolved, treat the total as an estimate, not a complete entry-liability determination.

GET/v1/lookup
curl "https://api.ustariffrates.com/v1/lookup?hts=7304.19.10&country=CN" \
  -H "X-Api-Key: YOUR_API_KEY"

Common uses

  • Power duty-rate checks in quoting, ERP, TMS, or landed-cost systems.
  • Inspect the base rate and additional programs as separate layers, not one opaque percentage.
  • Review effective-date, source, and unresolved-fact context before using a result in a quote or entry workflow.

Response fields

htscountryrate_stackcalculation_statusunresolved_factstotal_estimatedwarningsrisk_layersprovenance

When is a tariff lookup not the final answer?

A returned total is not a complete entry-liability decision. Check unresolved facts, exclusions, and AD/CVD risk separately; some cases need product, producer, claim, or entry details before a total can be used.

Review the API reference

Data and source context

US Tariff Rates combines HTS schedule data with tariff program and trade-remedy context. Some endpoints expose source and provenance fields directly; historical replay is supported where the current data set has effective-date coverage, with fuller archive coverage planned for audit and refund workflows.

Check the primary sources

Use the result's source context to verify the applicable schedule, notice, and trade-remedy record for your entry facts and assessment date.

Frequently asked questions