---
title: "GetRouteExplorerLane"
method: GET
path: "/api/supply-chain/v1/get-route-explorer-lane"
tags: ["SupplyChainService"]
---

# GetRouteExplorerLane

`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

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.

## Query parameters

- `fromIso2` string, required
- `toIso2` string, required
- `hs2` string, required
- `cargoType` string, required
- `jmespath` string

## Response `200`

OK

- WorldmonitorSupplyChainV1GetRouteExplorerLaneResponse
  - `fromIso2` string
  - `toIso2` string
  - `hs2` string
  - `cargoType` string
  - `primaryRouteId` string: Primary trade route ID from TRADE_ROUTES config. Empty when no modeled lane.
  - `primaryRouteGeometry` WorldmonitorSupplyChainV1GeoPoint[]
    - `lon` number, double
    - `lat` number, double
  - `chokepointExposures` WorldmonitorSupplyChainV1ChokepointExposureSummary[]
    - `chokepointId` string
    - `chokepointName` string
    - `exposurePct` integer
  - `bypassOptions` WorldmonitorSupplyChainV1BypassCorridorOption[]
    - `id` string
    - `name` string
    - `type` string
    - `addedTransitDays` integer
    - `addedCostMultiplier` number, double
    - `warRiskTier` string
    - `status` 'CORRIDOR_STATUS_UNSPECIFIED' | 'CORRIDOR_STATUS_ACTIVE' | 'CORRIDOR_STATUS_PROPOSED' | 'CORRIDOR_STATUS_UNAVAILABLE': Status of a bypass corridor for UI labeling. "active" means usable today; "proposed" means documented but not yet built/operational; "unavailable" means blockaded or otherwise blocked from use.
    - `fromPort` WorldmonitorSupplyChainV1GeoPoint: GeoPoint is a [longitude, latitude] pair.
      - `lon` number, double
      - `lat` number, double
    - `toPort` WorldmonitorSupplyChainV1GeoPoint: GeoPoint is a [longitude, latitude] pair.
      - `lon` number, double
      - `lat` number, double
  - `warRiskTier` string
  - `disruptionScore` number, double
  - `estTransitDaysRange` WorldmonitorSupplyChainV1NumberRange: Inclusive integer range for transit days / freight USD estimates.
    - `min` integer
    - `max` integer
  - `estFreightUsdPerTeuRange` WorldmonitorSupplyChainV1NumberRange: Inclusive integer range for transit days / freight USD estimates.
    - `min` integer
    - `max` integer
  - `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

## Other responses

- `400`: Validation error
- `401`: Missing or invalid API key.
- `403`: PRO entitlement access denied.
- `429`: Rate limit exceeded.
- `503`: Service unavailable. Billing-verification responses include code and X-Billing-Verification; other gateway infrastructure failures use the generic GatewayError shape.
- `default`: Gateway or handler error response.

---

[API](https://skmtc.dev/worldmonitor/apis/worldmonitor-api.md) · [All operations](https://skmtc.dev/worldmonitor/apis/worldmonitor-api/llms.txt) · [OpenAPI document](https://skmtc.dev/worldmonitor/apis/worldmonitor-api/revisions/e3dc8463a5c9?raw)