Electricity mix
Forecast
get
electricity-mix/forecastWhen signed in, you can use the interactive API Playground to query the Electricity Maps API directly from this page
Get the electricity mix for a zone (forecast).
Query Parameters
temporalGranularity?string
The temporal granularity of the data to get.
Default
"hourly"Example
"hourly"Value in
- "5_minutes"
- "15_minutes"
- "hourly"
- "daily"
- "monthly"
- "quarterly"
- "yearly"
zone?string
An Electricity Maps zone key.
Example
"DK-DK2"lat?number
Latitude of the location to get the data for.
Example
41.877lon?number
Longitude of the location to get the data for.
Example
-88.0703disableCallerLookup?boolean
If true, the fallback IP-based zone lookup will not be performed.
Default
falsehorizonHours?number
The number of hours ahead to forecast.
Default
24Value in
- 6
- 24
- 48
- 72
breakdownType?string
Whether the breakdown accounts for imports (flow-traced) or only the zone's own generation (normal). An alternative to flowTraced; when both are given, breakdownType wins.
Default
"flow-traced"Example
"flow-traced"Value in
- "normal"
- "flow-traced"
flowTraced?boolean
If true, the response returns flow-traced (consumption-based) values.
Default
trueExample
trueResponse Body
application/json
application/json
application/json
curl -X GET "https://example.com/electricity-mix/forecast"{ "zone": "DK-DK2", "temporalGranularity": "hourly", "unit": "MW", "data": [ { "datetime": "2024-05-19T03:00:00.000Z", "updatedAt": "2025-07-25T12:32:42.039Z", "breakdownType": "flow-traced", "mix": { "nuclear": 0, "geothermal": 0, "biomass": 0, "coal": 0, "wind": 0, "solar": 0, "hydro": 0, "gas": 0, "oil": 0, "unknown": 0, "hydro storage": { "charge": 0, "discharge": 0 }, "battery storage": { "charge": 0, "discharge": 0 }, "flows": { "imports": 0, "exports": 0 } }, "isEstimated": false, "estimationMethod": "string" } ]}