Skip to main content
GET
GetCountryEnergyProfile

Authorizations

X-WorldMonitor-Key
string
header
required

User-issued WorldMonitor API key.

Query Parameters

country_code
string

ISO 3166-1 alpha-2 country code for the energy profile.

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

mixAvailable
boolean

Phase 1 — OWID structural mix (~200 countries)

mixYear
integer<int32>
coalShare
number<double>
gasShare
number<double>
oilShare
number<double>
nuclearShare
number<double>
renewShare
number<double>
windShare
number<double>
solarShare
number<double>
hydroShare
number<double>
importShare
number<double>
gasStorageAvailable
boolean

Phase 2 — EU gas storage

gasStorageFillPct
number<double>
gasStorageChange1d
number<double>
gasStorageTrend
string
gasStorageDate
string
electricityAvailable
boolean

Phase 2 — EU electricity (ENTSO-E countries: DE FR ES IT NL BE PL PT GB NO SE) US electricity is stored by EIA balancing area, not ISO2 — not available here

electricityPriceMwh
number<double>
electricitySource
string
electricityDate
string
jodiOilAvailable
boolean

Phase 2.5 — JODI Oil (~90+ countries)

jodiOilDataMonth
string
gasolineDemandKbd
number<double>
gasolineImportsKbd
number<double>
dieselDemandKbd
number<double>
dieselImportsKbd
number<double>
jetDemandKbd
number<double>
jetImportsKbd
number<double>
lpgDemandKbd
number<double>
crudeImportsKbd
number<double>
lpgImportsKbd
number<double>
jodiGasAvailable
boolean

Phase 2.5 — JODI Gas

jodiGasDataMonth
string
gasTotalDemandTj
number<double>
gasLngImportsTj
number<double>
gasPipeImportsTj
number<double>
gasLngShare
number<double>
ieaStocksAvailable
boolean

Phase 2.5 — IEA oil stocks (~31 IEA members)

ieaStocksDataMonth
string
ieaDaysOfCover
integer<int32>
ieaNetExporter
boolean
ieaBelowObligation
boolean
emberFossilShare
number<double>

Phase 3 — Ember monthly electricity mix

emberRenewShare
number<double>
emberNuclearShare
number<double>
emberCoalShare
number<double>
emberGasShare
number<double>
emberDemandTwh
number<double>
emberDataMonth
string
emberAvailable
boolean
sprRegime
string

Phase 4 — SPR policy classification

sprCapacityMb
number<double>
sprOperator
string
sprIeaMember
boolean
sprStockholdingModel
string
sprNote
string
sprSource
string
sprAsOf
string
sprAvailable
boolean
jodiOilObservedMeasurements
string[]

Per-field presence for partial JODI payloads. Existing numeric fields keep their proto3 zero defaults for compatibility; a path appears here only when that source measurement was actually observed, including valid zeroes. Values use the stable source paths from jodi-measurement-fields.json.

jodiGasObservedMeasurements
string[]

Same presence contract for JODI gas source paths.