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.
/v1/lookupcurl "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_layersprovenanceWhen 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 referenceData 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.
- USITC Harmonized Tariff Schedule — schedule text and duty columns
- Federal Register — published tariff and trade-remedy notices
- CBP trade remedies — customs implementation guidance