Skip to main content
GET
GetUsImportDuty

Authorizations

X-WorldMonitor-Key
string
header
required

User-issued WorldMonitor API key.

Query Parameters

hs_code
string
required

HTS code: 6, 8 or 10 digits, no dots ("870323").

Pattern: ^[0-9]{6}([0-9]{2}){0,2}$
partner_country
string
required

Exporter, 3-digit UN M49 ("156").

Pattern: ^[0-9]{3}$
jmespath
string

Optional JMESPath expression applied server-side to project or reduce the JSON response before it is returned (mirrors the MCP jmespath argument). Invalid expressions, expressions larger than 1024 UTF-8 bytes, or projections that exceed the 256 KB output cap return HTTP 400 with a {_jmespath_error, original_keys} envelope. Grammar and worked examples: https://www.worldmonitor.app/docs/mcp-jmespath.

Response

Successful response

Current US duty on a product from one country.

hsCode
string

HTS code, as requested.

partnerCountry
string

Exporter code, as requested.

htsRelease
string

HTS release of the chapter 99 index ("2026HTSRev21").

lines
object[]
additionalDutiesLoaded
boolean

False when the chapter 99 index was unavailable.

source
string

Data source.

sourceUrl
string

HTS search page for the code.

upstreamUnavailable
boolean

True on a fault, false on a coverage answer.

unavailableReason
enum<string>

Why no line was served. NOT_COVERED is final; UPSTREAM_UNAVAILABLE is a fault.

Available options:
US_IMPORT_DUTY_UNAVAILABLE_REASON_UNSPECIFIED,
US_IMPORT_DUTY_UNAVAILABLE_REASON_INVALID_REQUEST,
US_IMPORT_DUTY_UNAVAILABLE_REASON_NOT_COVERED,
US_IMPORT_DUTY_UNAVAILABLE_REASON_UPSTREAM_UNAVAILABLE