API v1
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
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.
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.
/api/v1/searchSearch HTS codes by product description or partial code
q (required), country, limit (1-50)
/api/v1/lookupLook up a specific HTS code with full duty breakdown
code (required), country
/api/v1/bulkBatch lookup — one credit per submitted row, including unmatched rows; failed work costs no credits
items[] with description/hts_code/country
/api/v1/pricesTrade 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)
/api/v1/concordanceEdition-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
/api/v1/convertDeprecated concordance compatibility adapter
code, source/from, target/to
/api/v1/trade-remediesAD/CVD orders and HTS-prefix screening matches
q (text search), hts (prefix screening), country, format=csv (Pro session required)
/api/v1/freshnessSource freshness and monitor health for public tariff data
none
/api/v1/keysManage your own API key (signed-in session required)
verified session; optional matching email
/api/v1/docsMachine-readable API documentation (JSON)
none
/mcpStateless hosted MCP with 12 curated tariff tools
API key required; optional X-Mcp-Client-Name and X-Mcp-Client-Version
/v1/tariffsEnumerate 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
/v1/lookupCurrent rate stack for an HTS code, with FR-cited provenance and as_of retroactive lookups
hts (required), country, as_of, compat (legacy|none)
/v1/calculateLanded-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)
/v1/audit/entryAudit 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)
Dedicated pages for common integration paths: tariff search, duty-rate checks, landed-cost modeling, and trade-remedy screening.
Connect OpenAI Responses, Claude Code, Claude API, Cursor, or any Streamable HTTP MCP client.
Search and look up Harmonized Tariff Schedule codes by product description or known code.
Retrieve duty stacks, surcharge context, and tariff-rate evidence for import workflows.
Estimate duty, fees, freight inputs, and total landed cost before shipment decisions.
Screen products and origins for AD/CVD and special-duty risk before entry.
curl "https://ustariffrates.com/api/v1/search?q=steel+rebar&country=china&limit=5" \
-H "X-Api-Key: YOUR_API_KEY"| Field | Description |
|---|---|
| api_version | Public API major version; stays v1 for backward-compatible additive changes |
| schema_version | Additive response schema generation |
| hts_code | 10-digit Harmonized Tariff Schedule code |
| description | Official USITC description |
| base_duty | Base ad valorem or specific duty rate |
| section_122 | Historical Section 122 reciprocal import surcharge for entries before its July 24, 2026 expiration; current entries return zero |
| section_232 | Section 232 rate — 50% steel, 50% aluminum, 50% copper, 25% autos |
| section_301 | Section 301 tariff rate for the requested origin (%) |
| section_301_china | Deprecated China-only compatibility mirror of section_301; use section_301 plus the origin scope instead, or pass compat=none to omit it |
| total_estimated | Estimated duty rate for known components as a percentage string; incomplete results require additional facts and risk layers are reported separately. |
Pass your API key via any of these methods:
X-Api-Key: YOUR_KEYAuthorization: Bearer YOUR_KEY?api_key=YOUR_KEYUnauthenticated requests are IP-rate-limited to 50/month.
Sign in to create and manage keys for your account or a client workspace.
Manage API keysPer-tier request caps, enforced server-side. Monthly caps reset on the 1st; bulk limits cap items per /api/v1/bulk request.
| Plan | Price | API requests | Bulk lookup | Notes |
|---|---|---|---|---|
| Free | $0 | 50 requests/mo | 10 items/request | Anonymous use (no key) shares the same 50/mo cap per IP |
| Pro | $49/mo ($399/yr) | 5,000 requests/mo | 100 items/request | All Pro app features included |
| Team | $199/mo ($1,590/yr) | 50,000 requests/mo | 500 items/request | Customs entry audit API + shared billing |
| Enterprise | Custom | Unlimited | 1,000 items/request | SLA, dedicated onboarding |