SupplyChainService

GetRouteExplorerLane

GetRouteExplorerLane returns the primary maritime route, chokepoint exposures, bypass options with geometry, war risk, and static transit/freight estimates for a country pair + HS2 + cargo type. PRO-gated. Wraps the route-intelligence vendor endpoint's compute with browser-callable auth and adds fields needed by the Route Explorer UI. Requires entitlement tier >= 1.

get/api/supply-chain/v1/get-route-explorer-lane

Request

  • Base URL: https://api.worldmonitor.app
  • URL: https://api.worldmonitor.app/api/supply-chain/v1/get-route-explorer-lane
  • Auth: one of:
    • API key in header X-WorldMonitor-Key
    • API key in header X-Api-Key
    • HTTP bearer

Query parameters

fromIso2string required

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

toIso2string required

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

hs2string required

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

cargoTypestring required

One of: container, tanker, bulk, roro

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

fromIso2string
toIso2string
hs2string
cargoTypestring
primaryRouteIdstring

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

warRiskTierstring
disruptionScorenumber double
noModeledLaneboolean

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.

fetchedAtstring

Changes

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