IntelligenceService

GetCountryEnergyProfile

GetCountryEnergyProfile aggregates Phase 1/2/2.5 energy data per country.

get/api/intelligence/v1/get-country-energy-profile

Request

  • Base URL: https://api.worldmonitor.app
  • URL: https://api.worldmonitor.app/api/intelligence/v1/get-country-energy-profile
  • Auth: one of:
    • API key in header X-WorldMonitor-Key
    • API key in header X-Api-Key

Query parameters

country_codestring

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

jmespathstring

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

OK

mixAvailableboolean

Phase 1 — OWID structural mix (~200 countries)

mixYearinteger
coalSharenumber double
gasSharenumber double
oilSharenumber double
nuclearSharenumber double
renewSharenumber double
windSharenumber double
solarSharenumber double
hydroSharenumber double
importSharenumber double
gasStorageAvailableboolean

Phase 2 — EU gas storage

gasStorageFillPctnumber double
gasStorageChange1dnumber double
gasStorageTrendstring
gasStorageDatestring
electricityAvailableboolean

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

electricityPriceMwhnumber double
electricitySourcestring
electricityDatestring
jodiOilAvailableboolean

Phase 2.5 — JODI Oil (~90+ countries)

jodiOilDataMonthstring
gasolineDemandKbdnumber double
gasolineImportsKbdnumber double
dieselDemandKbdnumber double
dieselImportsKbdnumber double
jetDemandKbdnumber double
jetImportsKbdnumber double
lpgDemandKbdnumber double
crudeImportsKbdnumber double
lpgImportsKbdnumber double
jodiGasAvailableboolean

Phase 2.5 — JODI Gas

jodiGasDataMonthstring
gasTotalDemandTjnumber double
gasLngImportsTjnumber double
gasPipeImportsTjnumber double
gasLngSharenumber double
ieaStocksAvailableboolean

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

ieaStocksDataMonthstring
ieaDaysOfCoverinteger
ieaNetExporterboolean
ieaBelowObligationboolean
emberFossilSharenumber double

Phase 3 — Ember monthly electricity mix

emberRenewSharenumber double
emberNuclearSharenumber double
emberCoalSharenumber double
emberGasSharenumber double
emberDemandTwhnumber double
emberDataMonthstring
emberAvailableboolean
sprRegimestring

Phase 4 — SPR policy classification

sprCapacityMbnumber double
sprOperatorstring
sprIeaMemberboolean
sprStockholdingModelstring
sprNotestring
sprSourcestring
sprAsOfstring
sprAvailableboolean
jodiOilObservedMeasurementsstring[]
jodiGasObservedMeasurementsstring[]
importShareAvailableboolean

Primary-energy import dependency comes from the audited resilience-static source. It is independent from the OWID electricity-generation mix.

importShareYearinteger
importShareSourcestring

Changes

No recorded changes to this operation across all 1 revision of this API.