API ReferenceRenewable level

Past range

get
/v4/renewable-percentage-level/past-range

Get the renewable percentage level for a zone over a past range. Levels are classified on hourly data, and the range may not exceed 10 days.

Query Parameters

zone optional

An Electricity Maps zone key.

Example: "DK-DK2"
start required

The start datetime to get the data for.

Format: ISO 8601 datetime
Example: "2024-05-19T03:00:00Z"
end required

The end datetime to get the data for.

Format: ISO 8601 datetime
Example: "2024-05-19T08:00:00Z"
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
disableCallerLookup optional

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

Default: false

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v4/renewable-percentage-level/past-range?start=2024-05-19T03%3A00%3A00Z&end=2024-05-19T08%3A00%3A00Z"
{  "zone": "DK-DK2",  "data": [    {      "level": "low",      "datetime": "2024-05-19T03:00:00.000Z"    }  ]}

Playground

get
/v4/renewable-percentage-level/past-range
Explore the API with a 14-day trial.