Skip to main content
GET
GetBilateralTariff

Authorizations

X-WorldMonitor-Key
string
header
required

User-issued WorldMonitor API key.

Query Parameters

reporting_country
string
required

Importer, 3-digit UN M49 ("840"). EU members use the EU schedule.

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

Exporter, 3-digit UN M49 ("484"). "000" returns MFN only.

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

Six-digit HS subheading ("870323").

Pattern: ^[0-9]{6}$
year
integer<int32>

Tariff year; 0 = latest year TRAINS lists for the importer.

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

Applied tariff on one HS6 product between two countries.

reportingCountry
string

Importer code, as requested.

partnerCountry
string

Exporter code, as requested.

hsCode
string

HS6 code, as requested.

year
integer<int32>

Year served; 0 when none.

nomenclature
string

HS edition the importer filed in ("H5" = HS 2017).

basis
enum<string>

Source of applied_rate.

Available options:
APPLIED_TARIFF_BASIS_UNSPECIFIED,
APPLIED_TARIFF_BASIS_PREFERENTIAL,
APPLIED_TARIFF_BASIS_MFN,
APPLIED_TARIFF_BASIS_MFN_PREFERENCES_NOT_REPORTED
appliedRate
object

Simple average across the importer's national tariff lines, in percent.

mfnRate
object

Simple average across the importer's national tariff lines, in percent.

preferentialRate
object

Simple average across the importer's national tariff lines, in percent.

groupPreferences
object[]
source
string

Data source.

sourceUrl
string

WITS query behind the rows.

upstreamUnavailable
boolean

True on a fault, false on a coverage answer.

unavailableReason
enum<string>

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

Available options:
BILATERAL_TARIFF_UNAVAILABLE_REASON_UNSPECIFIED,
BILATERAL_TARIFF_UNAVAILABLE_REASON_INVALID_REQUEST,
BILATERAL_TARIFF_UNAVAILABLE_REASON_NOT_COVERED,
BILATERAL_TARIFF_UNAVAILABLE_REASON_UPSTREAM_UNAVAILABLE
filingReporter
string

Reporter code queried: "918" for EU members.

mfnAveRate
object

Simple average across the importer's national tariff lines, in percent.