API v1

US Tariff Rates API

29,862 distinct HTS codes. Real-time duty rates. Section 301, 232, AD/CVD overlays. One API call to know what you'll pay at the border.

Quick answer for developers

What can you build with the USTariffRates API?

The API supports HTS search, exact tariff-rate lookup, landed-cost calculation, bulk classification, source freshness checks, and trade-remedy screening for US import workflows. Use it to enrich product catalogs, power broker tools, quote landed cost, and monitor tariff exposure by HTS code.

Endpoints

Two API surfaces share a single API key. The first (ustariffrates.com) covers the broader endpoint set used by the dashboard and most integrations. The second (api.ustariffrates.com) is focused on provenance-rich duty math, entry audits, and a hosted MCP endpoint for agent workflows. Connect directly to https://mcp.ustariffrates.com with your API key—no local package required. Calls use the plan, quota, and billing rules of the customer account behind that key. Agent wallet payments are reserved for a future release and are not enabled today.

ustariffrates.com
GET/api/v1/search

Search HTS codes by product description or partial code

q (required), country, limit (1-50)

GET/api/v1/lookup

Look up a specific HTS code with full duty breakdown

code (required), country

POST/api/v1/bulk

Batch lookup — one credit per submitted row, including unmatched rows; failed work costs no credits

items[] with description/hts_code/country

GET/api/v1/prices

Trade statistics — import values by country for an HTS code

hts (required), country, months (1-24, default 12), all=true (include every country, default top 10)

GET/api/v1/concordance

Edition-aware candidate mappings across China tariff codes, US HTS, EU CN/TARIC, GB Commodity, and Brazil NCM

code, source, target (repeat up to 5); optional as_of, source_edition, target_edition, include, cursor, limit

GET/api/v1/convert

Deprecated concordance compatibility adapter

code, source/from, target/to

GET/api/v1/trade-remedies

AD/CVD orders and HTS-prefix screening matches

q (text search), hts (prefix screening), country, format=csv (Pro session required)

GET/api/v1/freshness

Source freshness and monitor health for public tariff data

none

POST/api/v1/keys

Manage your own API key (signed-in session required)

verified session; optional matching email

GET/api/v1/docs

Machine-readable API documentation (JSON)

none

api.ustariffrates.comProvenance + MCP
POST/mcp

Stateless hosted MCP with 12 curated tariff tools

API key required; optional X-Mcp-Client-Name and X-Mcp-Client-Version

GET/v1/tariffs

Enumerate Section 201, 232, 301, or 338 HTS coverage without knowing the codes first

program=section_201|section_232|section_301|section_338; origin and as_of required; optional level, action, prefix, status, limit, cursor; coverage_mode is Section 301-only; paid API plan required

GET/v1/lookup

Current rate stack for an HTS code, with FR-cited provenance and as_of retroactive lookups

hts (required), country, as_of, compat (legacy|none)

POST/v1/calculate

Landed-duty calculator with structured quantity support for specific and compound rates, itemized duty layers, and source provenance

hts, country, value, mode, quantities[], alcohol_by_volume_percent, product_content (json body)

POST/v1/audit/entry

Audit a 7501 entry against effective-date rates; structured missing facts replace false zero-duty results. Team or Enterprise only

entry_number, as_of, lines[] with hts/country/value/declared_duty required and optional quantities[] (json body)

API guides

Dedicated pages for common integration paths: tariff search, duty-rate checks, landed-cost modeling, and trade-remedy screening.

Code examples

Search
curl "https://ustariffrates.com/api/v1/search?q=steel+rebar&country=china&limit=5" \
  -H "X-Api-Key: YOUR_API_KEY"

Response fields

FieldDescription
api_versionPublic API major version; stays v1 for backward-compatible additive changes
schema_versionAdditive response schema generation
hts_code10-digit Harmonized Tariff Schedule code
descriptionOfficial USITC description
base_dutyBase ad valorem or specific duty rate
section_122Historical Section 122 reciprocal import surcharge for entries before its July 24, 2026 expiration; current entries return zero
section_232Section 232 rate — 50% steel, 50% aluminum, 50% copper, 25% autos
section_301Section 301 tariff rate for the requested origin (%)
section_301_chinaDeprecated China-only compatibility mirror of section_301; use section_301 plus the origin scope instead, or pass compat=none to omit it
total_estimatedEstimated duty rate for known components as a percentage string; incomplete results require additional facts and risk layers are reported separately.

Authentication

Pass your API key via any of these methods:

Header:X-Api-Key: YOUR_KEY
Bearer:Authorization: Bearer YOUR_KEY
Query:?api_key=YOUR_KEY

Unauthenticated requests are IP-rate-limited to 50/month.

Get your API key

Sign in to create and manage keys for your account or a client workspace.

Manage API keys

API pricing & limits

Per-tier request caps, enforced server-side. Monthly caps reset on the 1st; bulk limits cap items per /api/v1/bulk request.

PlanPriceAPI requestsBulk lookupNotes
Free$050 requests/mo10 items/requestAnonymous use (no key) shares the same 50/mo cap per IP
Pro$49/mo ($399/yr)5,000 requests/mo100 items/requestAll Pro app features included
Team$199/mo ($1,590/yr)50,000 requests/mo500 items/requestCustoms entry audit API + shared billing
EnterpriseCustomUnlimited1,000 items/requestSLA, dedicated onboarding
View pricing plans

Resources

Data source: USITC HTS 2026 Basic Edition · Questions? Contact us

Frequently asked questions