Carbon intensity

Forecast

get
/carbon-intensity/forecast
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 carbon intensity forecast for a zone

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.

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
horizonHours?number

The number of hours ahead to forecast.

Default24

Value in

  • 6
  • 24
  • 48
  • 72

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/carbon-intensity/forecast"
{  "zone": "DK-DK2",  "forecast": [    {      "carbonIntensity": 101,      "datetime": "2025-08-20T09:00:00.000Z"    }  ],  "updatedAt": "2026-01-01T00:00:00.000Z"}

Latest GET

Get the latest carbon intensity for a zone

Past GET

Get the fossil-only carbon intensity for a zone (past).