Helpers

Updated since

get
/updated-since
When signed in, you can use the interactive API Playground to query the Electricity Maps API directly from this page

List data points for a zone that have been updated since a given datetime.

Query Parameters

since*string

Only return data points updated since this datetime.

Formatdate-time
Example"2024-05-19T03:00:00Z"
start*string

The start datetime to get the data for.

Formatdate-time
Example"2024-05-19T03:00:00Z"
end*string

The end datetime to get the data for.

Formatdate-time
Example"2024-05-19T08:00:00Z"
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
limit?integer

Maximum number of updates to return. Cannot exceed 1000.

Rangevalue <= 1000
Default100
Example100
threshold?string

ISO-8601 duration; only report updates where the value moved by at least this much time.

Example"PT0H0M0S"
disableEstimations?boolean

If true, the response will exclude estimated data points

Defaultfalse

Response Body

application/json

application/json

curl -X GET "https://example.com/updated-since?since=2024-05-19T03%3A00%3A00Z&start=2024-05-19T03%3A00%3A00Z&end=2024-05-19T08%3A00%3A00Z"
{  "zone": "DK-DK2",  "updates": [    {      "datetime": "2024-05-19T03:00:00.000Z",      "updated_at": "2025-07-25T12:32:42.039Z",      "isEstimated": false,      "estimationMethod": "string"    }  ],  "threshold": "PT0H0M0S",  "limit": 100,  "limitReached": false}