API ReferenceNet load

Past

get
/v4/net-load/past

Get the net load for a zone at a given datetime

Query Parameters

datetime required

The datetime to get the data for. By default this needs to be the specific hour unless another temporal granularity is requested.

Format: ISO 8601 datetime
Example: "2024-05-19T03:00:00Z"
zone optional

An Electricity Maps zone key.

Example: "DK-DK2"
temporalGranularity optional

The temporal granularity of the data to get.

Default: "hourly"
One of: "5_minutes", "15_minutes", "hourly", "daily", "monthly", "quarterly", "yearly"
lat optional

Latitude of the location to get the data for.

Example: 41.877
lon optional

Longitude of the location to get the data for.

Example: -88.0703
emissionFactorType optional

The type of emission factors to use.

Default: "lifecycle"
One of: "direct", "lifecycle"
flowTraced optional

Whether values are flow-traced. true accounts for electricity flows and returns consumption-based values; false returns values for the zone's own generation only.

Default: true
Example: false
disableCallerLookup optional

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

Default: false
disableEstimations optional

If true, the response will exclude estimated data points

Default: false

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v4/net-load/past?datetime=2024-05-19T03%3A00%3A00Z"
{  "zone": "DK-DK2",  "datetime": "2024-05-19T03:00:00.000Z",  "createdAt": "2024-05-16T03:48:50.419Z",  "updatedAt": "2025-07-25T12:32:42.039Z",  "value": 4321,  "unit": "MW",  "source": "entsoe.eu",  "isEstimated": false,  "estimationMethod": "string",  "temporalGranularity": "hourly",  "flowTraced": true,  "aggregationPeriod": "hourly"}

Playground

get
/v4/net-load/past
Explore the API with a 14-day trial.

History GET

Get the last 24 hours of net load for a zone

Past range GET

Get the net load for a zone and a given datetime range. > [!CAUTION] > The time range a single request may cover depends on the granularity: 3 days for `5_minutes`, 4 days for `15_minutes`, 10 days for `hourly`, 365 days for `daily`, and 30 years for `monthly`, `quarterly` and `yearly`. > If you need more data, **you can loop over time ranges**.