Skip to main content
GET
GetCountryCostShock

Authorizations

X-WorldMonitor-Key
string
header
required

User-issued WorldMonitor API key.

Query Parameters

iso2
string
required

ISO 3166-1 alpha-2 country code for the importing country.

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

Chokepoint identifier to model as disrupted.

hs2
string

HS2 chapter (default: "27")

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

iso2
string
chokepointId
string
hs2
string
supplyDeficitPct
number<double>

Average refined-product supply deficit % under full closure (Gasoline/Diesel/Jet fuel/LPG average; HS 27 only)

coverageDays
integer<int32>

Energy stockpile coverage in days (IEA data, HS 27 only; 0 for non-energy sectors or net exporters)

warRiskPremiumBps
integer<int32>

War risk insurance premium in basis points for this chokepoint

warRiskTier
enum<string>

War risk tier derived from Lloyd's JWC Listed Areas + OSINT threat classification. This is a FREE field (no PRO gate) — it exposes the existing server-internal threatLevel from ChokepointConfig, making it available to clients for badges and bypass corridor scoring.

Available options:
WAR_RISK_TIER_UNSPECIFIED,
WAR_RISK_TIER_NORMAL,
WAR_RISK_TIER_ELEVATED,
WAR_RISK_TIER_HIGH,
WAR_RISK_TIER_CRITICAL,
WAR_RISK_TIER_WAR_ZONE
hasEnergyModel
boolean

Whether supply_deficit_pct and coverage_days are modelled (true) or unavailable (false)

unavailableReason
string

Null/unavailable explanation for non-energy sectors

fetchedAt
string