Skip to main content
POST
Look up lines of the US Harmonized Tariff Schedule with their scheduled rate: the general, special and column 2 (other) rates for a heading such as 7408.11, or candidate lines for a keyword such as copper wire. Lines come in schedule order and keep their indent: for a heading lookup every line beneath it is returned, so a line sits under the nearest earlier line with a lower indent; a keyword search returns only the matching lines, without their ancestors, so there indent is depth only and says nothing about which heading a line belongs to. A heading has no rate of its own, its rates are on the indented lines below. This is the scheduled rate only: it does not add duties imposed by trade-remedy or emergency actions; footnotes are returned as the schedule gives them, each with the rate column(s) it qualifies, and additional-duties notes as given. It is a lookup, not a classification: it does not choose a code for a product, so a keyword search returns candidates for the caller to choose from. A keyword of several words matches lines containing any of them (copper wire returns copper ores as well as wire); wrap the words in double quotes to match the exact phrase ("copper wire"). Covers goods imported into the US. total is how many lines the schedule search matched, as the source counts them; lines is cut to limit. No match is a completed result with total 0.

​
Authentication

Requires x402 payment in the payment-signature header.

​
Request Body

​
string
required
A tariff heading such as 7408.11, or a keyword such as copper wire. Several words match any of them; wrap them in double quotes for the exact phrase. 2 to 80 characters.
​
integer
Most lines to return, in schedule order. Default 20. From 1 to 50. Defaults to 20.

​
Response (200 OK)

Top-level envelope: success (boolean) and data (object). All fields below are nested under data.
​
string
Durable job ID for audit and lookup
​
string
Job status: completed
​
string
Always product_duty_rate
​
object
The answer, described under Result below
​
object
Where the answer came from and when
​
string
The public body the data comes from. Always US International Trade Commission.
​
string
public when the data comes from a public body, commercial otherwise
​
string
When the lookup was made, as an ISO 8601 UTC time
​
string
When the source says the fact was last updated, or null when the source gives no date

​
Result

Nested under data.result.
​
number
How many lines of the schedule the source matched, before the limit.
​
object[]
Matching lines in schedule order, cut to the limit.
​
string
Tariff line number, such as 7408.11.30.00; a heading has fewer segments.
​
string
Description.
​
number
Depth in the schedule tree. In a heading lookup a line sits beneath the nearest earlier line with a lower indent; in a keyword search the ancestors are absent, so indent is depth only.
​
string
General (column 1) scheduled rate, as written; null on a heading.
​
string
Special scheduled rate with its program codes, as written. null when the source gives no value.
​
string
Column 2 scheduled rate, as written. null when the source gives no value.
​
string[]
Units of quantity reported for the line.
​
object[]
Footnotes on the line, each with the rate column(s) it qualifies.
​
string
The footnote, as the schedule gives it.
​
string[]
Which column(s) of the line it qualifies, as the schedule names them: general, special, other or units; empty when it names none.
​
string
Additional-duties note, as the schedule gives it. null when the source gives no value.
Price: $0.005 per lookup. See Pricing for every tool.

​
Notes

  • Results return inline. The finished job stays available at /v1/requests/{request_id}