---
title: "ComputeEnergyShockScenario"
method: GET
path: "/api/intelligence/v1/compute-energy-shock"
tags: ["IntelligenceService"]
---

# ComputeEnergyShockScenario

`GET /api/intelligence/v1/compute-energy-shock`

## Request

- Base URL: `https://api.worldmonitor.app`
- URL: `https://api.worldmonitor.app/api/intelligence/v1/compute-energy-shock`
- Auth: one of:
  - API key in header `X-WorldMonitor-Key`
  - API key in header `X-Api-Key`

ComputeEnergyShockScenario computes on-demand product supply shock for a given country + chokepoint.

## Query parameters

- `country_code` string
- `chokepoint_id` 'hormuz_strait' | 'malacca_strait' | 'suez' | 'bab_el_mandeb'
- `disruption_pct` integer
- `fuel_mode` 'oil' | 'gas' | 'both'
- `jmespath` string

## Response `200`

OK

- WorldmonitorIntelligenceV1ComputeEnergyShockScenarioResponse
  - `countryCode` string
  - `chokepointId` string
  - `disruptionPct` integer
  - `gulfCrudeShare` number, double
  - `crudeLossKbd` number, double
  - `products` WorldmonitorIntelligenceV1ProductImpact[]
    - `product` string
    - `outputLossKbd` number, double
    - `demandKbd` number, double
    - `deficitPct` number, double
  - `effectiveCoverDays` integer
  - `assessment` string
  - `dataAvailable` boolean
  - `jodiOilCoverage` boolean: v2 fields
  - `comtradeCoverage` boolean
  - `ieaStocksCoverage` boolean
  - `portwatchCoverage` boolean
  - `coverageLevel` string
  - `limitations` string[]
  - `degraded` boolean
  - `chokepointConfidence` string
  - `liveFlowRatio` number, double
  - `gasImpact` WorldmonitorIntelligenceV1GasImpact
    - `lngShareOfImports` number, double
    - `lngImportsTj` number, double
    - `lngDisruptionTj` number, double
    - `totalDemandTj` number, double
    - `deficitPct` number, double
    - `dataAvailable` boolean
    - `assessment` string
    - `storage` WorldmonitorIntelligenceV1GasStorageBuffer
      - `fillPct` number, double
      - `gasTwh` number, double
      - `bufferDays` number, double
      - `trend` string
      - `date` string
      - `scope` string
    - `dataSource` string
  - `gasSensitivity` WorldmonitorIntelligenceV1GasSensitivity
    - `lngShareOfImports` number, double: Fraction, not percent. Absent when the measurement is unavailable.
    - `lngImportsTj` number, double
    - `lngDisruptionTj` number, double: Assumed monthly LNG loss against the route baseline, independent of current shipping flow.
    - `totalDemandTj` number, double
    - `deficitPct` number, double: Loss as percent of recorded demand. May exceed 100; not a supply-shortage estimate.
    - `dataAvailable` boolean
    - `assessment` string
    - `storage` WorldmonitorIntelligenceV1GasStorageObservation
      - `fillPct` number, double
      - `gasTwh` number, double
      - `trend` string
      - `date` string
      - `scope` string
    - `dataSource` string
    - `dataMonth` string: JODI observation month (YYYY-MM), or empty when unknown. Availability does not imply freshness.
    - `modelBasis` string: "assumed_route_sensitivity". No country-specific supplier exposure is measured.

## Other responses

- `400`: Validation error
- `401`: Missing or invalid API key.
- `403`: API access requires an active subscription (the API key's subscription is inactive or expired).
- `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)