---
title: "GetCountryEnergyProfile"
method: GET
path: "/api/intelligence/v1/get-country-energy-profile"
tags: ["IntelligenceService"]
---

# GetCountryEnergyProfile

`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`

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

## Query parameters

- `country_code` string
- `jmespath` string

## Response `200`

OK

- WorldmonitorIntelligenceV1GetCountryEnergyProfileResponse
  - `mixAvailable` boolean: Phase 1 — OWID structural mix (~200 countries)
  - `mixYear` integer
  - `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
  - `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[]
  - `jodiGasObservedMeasurements` string[]
  - `importShareAvailable` boolean: Primary-energy import dependency comes from the audited resilience-static source. It is independent from the OWID electricity-generation mix.
  - `importShareYear` integer
  - `importShareSource` string

## 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)