TradeService

GetUsImportDuty

Current US duty on one product from one country (USITC HTS). PRO-gated. Requires entitlement tier >= 1.

get/api/trade/v1/get-us-import-duty

Request

  • Base URL: https://api.worldmonitor.app
  • URL: https://api.worldmonitor.app/api/trade/v1/get-us-import-duty
  • Auth: one of:
    • API key in header X-WorldMonitor-Key
    • API key in header X-Api-Key
    • HTTP bearer

Query parameters

hs_codestring required

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

partner_countrystring required

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

jmespathstring

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

OK

hsCodestring

HTS code, as requested.

partnerCountrystring

Exporter code, as requested.

htsReleasestring

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

additionalDutiesLoadedboolean

False when the chapter 99 index was unavailable.

sourcestring

Data source.

sourceUrlstring

HTS search page for the code.

upstreamUnavailableboolean

True on a fault, false on a coverage answer.

unavailableReason'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'

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

Changes

No recorded changes to this operation across all 1 revision of this API.