HTS Lookup & History API
LiveThe tariff schedule as of any date: lines, base rates, revisions, changes and the Chapter 99 measures that reach a code.
Look up an HTS line or subheading with the rate in force on a date, its history across releases, the releases themselves, the Chapter 99 measures (scope, conditions, stacking, dates, citations), and search the schedule's text.
At a glance
- Status
- Live
- Endpoints
- GET /v1/tariffs/hts/search
GET /v1/tariffs/hts/{hts}
GET /v1/tariffs/hts/{hts}/history
GET /v1/tariffs/revisions
GET /v1/tariffs/measures/{heading}
GET /v1/tariffs/measures - Cost
- 1 unit (each endpoint)
- MCP tools
- tariffs_hts_search
tariffs_hts_lookup
tariffs_hts_history
tariffs_revisions
tariffs_measure
tariffs_measures_for_hts - Data
- Tariffs dataset 1.0.0, built 2026-10-10.
Try it
Choose an endpoint and a sample, change the parameters, and send. Without a key the public demo answers the sample requests (marked demo, not counted against any quota, limited per IP address). With your key, or your account when you are signed in, any values work and the call counts against your plan. A key stays in this page's memory: it is never stored. Get a free key.
Summary
Response
{
"data": {
"query": "cap screws",
"words": ["cap", "screws"],
"count": 5,
"total": 8,
"offset": 0,
"lines": [
{
"hts": "7318158066",
"htsno": "7318.15.80.66",
"chapter": "73",
"indent": 9,
"description": "Cap screws",
"description_path": [
"Screws, bolts, nuts, coach screws, screw hooks, rivets, cotters, cotter pins, washers (including spring washers) and similar articles, of iron or steel:",
"Threaded articles:",
"… 8 more"
],
"units": ["kg"],
"general": null,
"release": "2026HTSRev21",
"score": 12.75,
"why": [
"cap: leads the line's text",
"screws: leads the line's text, at 3 levels",
"… 2 more"
]
},
{
"hts": "7318154000",
"htsno": "7318.15.40.00",
"chapter": "73",
"indent": 3,
"description": "Machine screws 9.5 mm or more in length and 3.2 mm or more in diameter (not including cap screws)",
"description_path": [
"Screws, bolts, nuts, coach screws, screw hooks, rivets, cotters, cotter pins, washers (including spring washers) and similar articles, of iron or steel:",
"Threaded articles:",
"… 2 more"
],
"units": ["kg"],
"general": "Free",
"release": "2026HTSRev21",
"score": 5.65,
"why": [
"cap: only in a use or exclusion, the line's text",
"screws: leads 1 level up, at 3 levels",
"… 1 more"
]
},
"… 3 more"
],
"order": "relevance: lines whose own text has the words first (then their parent lines, then headings), more for words leading the text, for the words as a phrase and for lines under a heading about the words; …",
"note": "Text search of the Harmonized Tariff Schedule (current release): every word must appear as a whole word (or its plural or singular) in the line or its parent lines. It finds lines whose text you alrea…"
},
"meta": {
"request_id": "req_…",
"api_version": "1",
"dataset": "tariffs",
"dataset_version": "1.0.0",
"dataset_built_at": "2026-10-10T16:05:28Z",
"data_status": "released",
"sources": [
{
"id": "usitc_harmonized_tariff_schedule_chapter",
"name": "USITC Harmonized Tariff Schedule (Chapter 99 PDFs, Change Records, releaseList, exportList REST)",
"url": "https://hts.usitc.gov/",
"licence": "U.S. Government work, public domain (17 U.S.C. 105)",
"commercial_redistribution_ok": true,
"retrieved": "2026-10-09/2026-10-10"
},
{
"id": "federal_register_proclamations_executive",
"name": "Federal Register (proclamations, executive orders, USTR/Commerce notices)",
"url": "https://www.federalregister.gov/",
"licence": "U.S. Government work, public domain (17 U.S.C. 105)",
"commercial_redistribution_ok": true,
"retrieved": "2026-10-09/2026-10-10"
},
"… 3 more"
],
"provenance_note": "Every value carries provenance (source, id or URL, retrieval date; method and confidence where an AI judged). Calculations list their inputs and method.",
"disclaimer": "Reference data and calculations from HTS codes you supply. Not classification advice and not a filing: entry filings need a licensed customs broker (CBP HQ H350722).",
"usage": "…"
}
}- 1Pin and diff: the version is also in the X-Dataset-Version header
Request
curl -s "https://api.htscalculator.com/demo/v1/tariffs/hts/search?q=cap+screws&limit=5"Endpoints
| Endpoint | What it does | Cost | MCP tool | Documentation |
|---|---|---|---|---|
| GET /v1/tariffs/hts/search | Search the tariff schedule's text | 1 unit | tariffs_hts_search | Docs |
| GET /v1/tariffs/hts/{hts} | HTS line lookup | 1 unit | tariffs_hts_lookup | Docs |
| GET /v1/tariffs/hts/{hts}/history | Revision history of an HTS line | 1 unit | tariffs_hts_history | Docs |
| GET /v1/tariffs/revisions | HTS revisions | 1 unit | tariffs_revisions | Docs |
| GET /v1/tariffs/measures/{heading} | A Chapter 99 measure | 1 unit | tariffs_measure | Docs |
| GET /v1/tariffs/measures | Measures that reach an HTS code | 1 unit | tariffs_measures_for_hts | Docs |
What is included
- Column 1 General rate on any date, with the HTS revision in force
- Rate intervals by release and established or discontinued events
- Chapter 99 measures with conditions, stacking rules, dates and quoted citations
- Text search of the schedule (search, not classification)
How it differs
- Effective-dated: the schedule as it stood on the date you ask about.
- Measures come with the stacking relations the engine applies.
- Every line links to the USITC release it was copied from.
Plans
One key and one plan cover every HTS Calculator product, this one included. Free: 2,500 units a month (2,500 calls of /v1/tariffs/hts/search). Developer $49 and Pro $249 a month. Caching inside your product is allowed, and so is use by AI agents. Plans and units.
Status: Live. All products.