API documentation | Electricity Maps

get

/v4/carbon-free-percentage-level/forecast

Get the forecasted carbon-free percentage level for a zone. Levels are classified on hourly data.

Query Parameters

zone optional

An Electricity Maps zone key.

Example: "DK-DK2"

horizonHours optional

The number of hours ahead to forecast.

Default: 24

One of: 6, 24, 48, 72

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

curl -X GET "https://example.com/v4/carbon-free-percentage-level/forecast"

{  "zone": "DK-DK2",  "forecast": [    {      "level": "low",      "datetime": "2024-05-19T03:00:00.000Z"    }  ]}

get

/v4/carbon-free-percentage-level/forecast

Explore the API with a 14-day trial.