Skip to main content
POST
Searches rulings published by US Customs and Border Protection, closest match first, with ruling numbers you can cite, dates, tariff numbers and revocation status. A ruling binds only the goods it describes. The rate itself comes from Duty Rate.

Authentication

Requires x402 payment in the payment-signature header.

Request Body

string
required
Search words, for example bluetooth speaker. 2 to 200 characters.
string
Keep rulings with a tariff number starting with this prefix, for example 8518, 8518.22 or 8518.22.0000.
integer
The most rulings to fetch before the optional tariff filter. From 1 to 20. Defaults to 10.

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 record_customs_rulings_find
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 Customs and Border Protection.
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 | null
The newest ruling date in the returned rulings; null when none has a known date.

Result

Nested under data.result.
number
Number of matches at the source before the optional tariff filter.
object[]
Matching rulings in source relevance order.
string
The ruling number identifying this public record.
string
The subject of the ruling.
string | null
The ruling date in US Eastern calendar time, YYYY-MM-DD; null when unknown.
string
The issuing collection: New York or Headquarters.
string
The source category of the ruling.
string[]
Tariff numbers listed in the ruling.
Related ruling numbers.
string[]
Rulings that modified this ruling.
string[]
Rulings that revoked this ruling.
boolean
Whether another ruling revoked it or the source marks it operationally revoked.
boolean
Whether the source marks the ruling as USMCA related.
string
The ruling page at the source.
See Pricing for this tool’s price. A wallet (x402) call receives it in the 402 quote before anything is charged; a call paid from prepaid credits is charged when the API accepts the request and answers 200.

Notes

  • New rulings are added daily as issued. Each answer includes the ruling date and a link to the ruling page.
  • The optional tariff_number prefix filters the returned page. Fewer than limit rulings may remain; total is the source match count before filtering.
  • Results return inline. The finished job stays available at /v1/requests/{request_id}