Skip to main content
GET
/
api
/
supply-chain
/
v1
/
get-country-cost-shock
GetCountryCostShock
curl --request GET \
  --url https://api.example.com/api/supply-chain/v1/get-country-cost-shock
{
  "iso2": "<string>",
  "chokepointId": "<string>",
  "hs2": "<string>",
  "supplyDeficitPct": 123,
  "coverageDays": 123,
  "warRiskPremiumBps": 123,
  "warRiskTier": "WAR_RISK_TIER_UNSPECIFIED",
  "hasEnergyModel": true,
  "unavailableReason": "<string>",
  "fetchedAt": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://worldmonitor.app/docs/llms.txt

Use this file to discover all available pages before exploring further.

Query Parameters

​
iso2
string
​
chokepointId
string
​
hs2
string

HS2 chapter (default: "27")

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