Electricity mix

Past Range

get
/electricity-mix/past-range
When signed in, you can use the interactive API Playground to query the Electricity Maps API directly from this page
Create an accountAlready have an account? Sign in

Get the electricity mix for a zone (past-range).

Query Parameters

start*string

The start datetime to get the data for.

Formatdate-time
Example"2024-05-19T03:00:00Z"
end*string

The end datetime to get the data for.

Formatdate-time
Example"2024-05-19T08:00:00Z"
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.

Example41.877
lon?number

Longitude of the location to get the data for.

Example-88.0703
disableCallerLookup?boolean

If true, the fallback IP-based zone lookup will not be performed.

Defaultfalse
disableEstimations?boolean

If true, the response will exclude estimated data points

Defaultfalse
estimationFallback?boolean

If false, estimated data points are excluded. Equivalent to disableEstimations=true.

Defaulttrue
Exampletrue
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.

Defaulttrue
Exampletrue

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/electricity-mix/past-range?start=2024-05-19T03%3A00%3A00Z&end=2024-05-19T08%3A00%3A00Z"
{  "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"    }  ]}

Past GET

Get the electricity mix for a zone (past).

History GET

Get the electricity mix for a zone (history).