Describe

Timeseries metadata

GET
/entities/{entity}/timeseries/{name}
X-API-Key<token>

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

entity*string

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.

name*string

The quantity, category.sub_category.definition[.component], never with the provider suffix.

Match^[a-z0-9_]+(\.[a-z0-9_]+){2,}$

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://grid.rebase.energy/api/v1/entities/string/timeseries/string"
{
  "entity": {
    "id": "IT-NO",
    "kind": "price_zone",
    "parent": "Italy",
    "country": "Italy",
    "sync_area": "sync:CESA"
  },
  "name": "consumption.realised_load.total_load",
  "definition": {
    "path": "consumption.realised_load.total_load",
    "measures": "net generation − exports + imports − absorbed (stored) energy",
    "document": "A65",
    "baseline": true,
    "ref": "https://eepublicdownloads.entsoe.eu/clean-documents/Transparency/MoP_Ref2_DDD_v3r4.pdf"
  },
  "component": null,
  "unit": "MW",
  "providers": [
    {
      "provider": "entsoe",
      "resolution": "PT15M",
      "extent": {
        "first": "2026-09-03T14:00:00Z",
        "last": "2026-10-12T10:45:00Z"
      },
      "publication_time": "measured",
      "latency_minutes": {
        "p05": 48,
        "p50": 63,
        "p95": 108
      },
      "coverage": 1,
      "annotations_seen": {
        "a03_forward_fill": 2
      },
      "values": "/entities/IT-NO/timeseries/consumption.realised_load.total_load/values?provider=entsoe"
    },
    {
      "provider": "terna",
      "resolution": "PT15M",
      "extent": {
        "first": "2026-09-30T22:00:00Z",
        "last": "2026-10-11T21:45:00Z"
      },
      "publication_time": "measured",
      "latency_minutes": {
        "p05": 1760,
        "p50": 6170,
        "p95": 10715
      },
      "coverage": 0.99,
      "annotations_seen": {},
      "values": "/entities/IT-NO/timeseries/consumption.realised_load.total_load/values?provider=terna"
    }
  ]
}
{
  "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"
  ]
}