Carbon free energy
History
get
carbon-free-energy/historyWhen signed in, you can use the interactive API Playground to query the Electricity Maps API directly from this page
Get the last 24 hours of carbon free energy share 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.
Example
41.877lon?number
Longitude of the location to get the data for.
Example
-88.0703disableCallerLookup?boolean
If true, the fallback IP-based zone lookup will not be performed.
Default
falsedisableEstimations?boolean
If true, the response will exclude estimated data points
Default
falseemissionFactorType?string
The type of emission factor to use.
Default
"lifecycle"Example
"lifecycle"Value in
- "direct"
- "lifecycle"
flowTraced?boolean
If true, the response returns flow-traced (consumption-based) values.
Default
trueExample
trueResponse Body
application/json
application/json
application/json
curl -X GET "https://example.com/carbon-free-energy/history"{ "zone": "string", "history": [ { "zone": "DK-DK2", "datetime": "2026-01-01T01:00:00.000Z", "updatedAt": "2026-01-01T02:00:00.000Z", "createdAt": "2026-01-01T00:00:00.000Z", "unit": "%", "value": 67, "flowTraced": true, "isEstimated": false, "estimationMethod": "string", "temporalGranularity": "hourly" } ], "temporalGranularity": "hourly"}