Timeseries values
One point per interval of the series, each with its valid_time, value, knowledge_time
and annotation; a point an upstream message stated (an outage change-point) also carries
that message (id, revision, reason, status). as_of selects the version:
as_of | Response | Returns |
|---|---|---|
| omitted | points | the latest version of every value |
| an RFC 3339 instant | points | every value as known at that instant |
an ISO 8601 duration (PT1H, P1D) | snapshots | one snapshot per period, anchored on start or on at |
rolling | snapshots | one snapshot per native step of the series |
A snapshot is the whole window as known at its instant. Snapshots at which nothing was known
are omitted and they stop at now even when end is later; an as_of in the future is 400.
Snapshot responses page with next, passed back as cursor. The Reading values guide shows each
case with an example.
Authorization
apiKey Optional. The Grid API key, also accepted as ?api_key=; without it a request is answered at 30 per minute per IP address. How to get a key: grid.rebase.energy/docs/v1/guides/authentication/. The key is in the API tab of the grid map.
In: header
Path Parameters
The entity id, e.g. SE-SE3, Sweden, sync:NSA, ca:DE-Amprion, bnd:GB-B1, sub:Blyth, border:FI~SE-SE3, icx:BritNed, or a plant, unit or portfolio: plant:11WD4SAEK2HS---S, unit:…, portfolio:… — the key, or the name after the kind prefix (plant:Säckingen hydroelectric plant). A name shared by several records is 404 listing their ids. See the Entities guide for every kind.
The quantity, category.sub_category.definition[.component], never with the provider suffix.
^[a-z0-9_]+(\.[a-z0-9_]+){2,}$Query Parameters
Required even when the quantity has one provider. Missing or unknown → 400 listing the providers, with a message naming the parameter to add (add provider=entsoe).
Inclusive valid-time bound: an ISO 8601 instant with a UTC offset, or a bare date (2026-11-09) meaning 00:00 UTC that day. The window [start, end] may hold at most 100000 points at the series' resolution; for a series without a known resolution it may span at most 366 days. A larger window is 400 (param: end): narrow it.
date-timeInclusive valid-time bound, in the same forms as start. Same window cap as start: at most 100000 points at the series' resolution, or 366 days without a known resolution; larger is 400. Bulk snapshots stop at now even when end is later; each snapshot still holds the rows forecast past now.
date-timeOmitted → flat, latest version of every value. An RFC 3339 instant → flat, every value as known at that instant.
rolling → bulk, one snapshot per native step of the series. An ISO 8601 duration (PT1H, PT6H, P1D) → bulk, one snapshot per period anchored on start.
A snapshot is the whole window as known at its instant. Snapshots at which nothing is known are omitted. An as_of in the future is 400.
Anchor for a period as_of, UTC wall-clock time.
^\d{2}:\d{2}$Bulk page size.
100value <= 1000Opaque, from next.
For a series with several columns (metadata columns), the subset to return, comma-separated: p50,p90. 400 on a plain series or an unknown column.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://grid.rebase.energy/api/v1/entities/string/timeseries/string/values?provider=string&start=2019-08-24T14%3A15%3A22Z&end=2019-08-24T14%3A15%3A22Z"{
"entity": "SE-SE3",
"name": "consumption.realised_load.total_load",
"provider": "entsoe",
"unit": "MW",
"resolution": "PT15M",
"publication_time": "measured",
"as_of": "latest",
"points": [
{
"valid_time": "2026-10-09T06:30:00Z",
"value": 10100,
"knowledge_time": "2026-10-09T08:02:59Z",
"annotation": null
},
{
"valid_time": "2026-10-09T06:45:00Z",
"value": 10100,
"knowledge_time": "2026-10-09T08:02:59Z",
"annotation": "a03_forward_fill"
},
{
"valid_time": "2026-10-09T07:00:00Z",
"value": 10474,
"knowledge_time": "2026-10-09T08:02:59Z",
"annotation": null
}
]
}{
"error": "not_found",
"message": "string",
"param": "string",
"anonymous": true,
"limit_rpm": 0,
"key_limit_rpm": 0,
"retry_after_s": 0,
"sign_up": "string",
"docs": "string",
"info": "string",
"reason": "string",
"closest": [
"string"
],
"providers": [
"string"
]
}{
"error": "not_found",
"message": "string",
"param": "string",
"anonymous": true,
"limit_rpm": 0,
"key_limit_rpm": 0,
"retry_after_s": 0,
"sign_up": "string",
"docs": "string",
"info": "string",
"reason": "string",
"closest": [
"string"
],
"providers": [
"string"
]
}{
"error": "not_found",
"message": "string",
"param": "string",
"anonymous": true,
"limit_rpm": 0,
"key_limit_rpm": 0,
"retry_after_s": 0,
"sign_up": "string",
"docs": "string",
"info": "string",
"reason": "string",
"closest": [
"string"
],
"providers": [
"string"
]
}{
"error": "not_found",
"message": "string",
"param": "string",
"anonymous": true,
"limit_rpm": 0,
"key_limit_rpm": 0,
"retry_after_s": 0,
"sign_up": "string",
"docs": "string",
"info": "string",
"reason": "string",
"closest": [
"string"
],
"providers": [
"string"
]
}{
"error": "not_found",
"message": "string",
"param": "string",
"anonymous": true,
"limit_rpm": 0,
"key_limit_rpm": 0,
"retry_after_s": 0,
"sign_up": "string",
"docs": "string",
"info": "string",
"reason": "string",
"closest": [
"string"
],
"providers": [
"string"
]
}