Skip to main content
GET
GetRouteExplorerLane

Authorizations

X-WorldMonitor-Key
string
header
required

User-issued WorldMonitor API key.

Query Parameters

fromIso2
string
required

ISO 3166-1 alpha-2 origin country code for the trade lane.

Pattern: ^[A-Z]{2}$
toIso2
string
required

ISO 3166-1 alpha-2 destination country code for the trade lane.

Pattern: ^[A-Z]{2}$
hs2
string
required

HS2 chapter code, e.g. "27", "85"

cargoType
string
required

One of: container, tanker, bulk, roro

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

fromIso2
string
toIso2
string
hs2
string
cargoType
string
primaryRouteId
string

Primary trade route ID from TRADE_ROUTES config. Empty when no modeled lane.

primaryRouteGeometry
object[]
chokepointExposures
object[]
bypassOptions
object[]
warRiskTier
string
disruptionScore
number<double>
estTransitDaysRange
object

Inclusive integer range for transit days / freight USD estimates.

estFreightUsdPerTeuRange
object

Inclusive integer range for transit days / freight USD estimates.

noModeledLane
boolean

True when the wrapper fell back to the origin's first route (no shared route between origin and destination clusters). Signals "no modeled lane" to the UI.

fetchedAt
string