Discover

Entity tree

Every grid entity as {id, kind, timeseries, children}. Borders and cables are not nodes; they are relations on the entities they touch. Plants, units and portfolios are not in the tree: each grid entity's own call summarises them in children and pages them under /entities/{entity}/plants, /units, /portfolios. Order inside a level is sync areas, countries, price zones, areas, boundaries, substations, then by timeseries count.

GET
/entities
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

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://grid.rebase.energy/api/v1/entities"
{
  "entities": [
    {
      "id": "Albania",
      "kind": "country",
      "timeseries": 0,
      "children": [
        {
          "id": "AL",
          "kind": "price_zone",
          "timeseries": 59
        }
      ]
    },
    {
      "id": "Andorra",
      "kind": "country",
      "timeseries": 0,
      "children": [
        {
          "id": "AD",
          "kind": "price_zone",
          "timeseries": 0
        }
      ]
    },
    {
      "id": "Austria",
      "kind": "country",
      "timeseries": 0,
      "children": [
        {
          "id": "AT",
          "kind": "price_zone",
          "timeseries": 202
        }
      ]
    },
    {
      "id": "Belgium",
      "kind": "country",
      "timeseries": 0,
      "children": [
        {
          "id": "BE",
          "kind": "price_zone",
          "timeseries": 199,
          "children": [
            {
              "id": "be:Brussels",
              "kind": "area",
              "timeseries": 15
            },
            {
              "id": "be:Flanders",
              "kind": "area",
              "timeseries": 45,
              "children": [
                {
                  "id": "be:Antwerp",
                  "kind": "area",
                  "timeseries": 15
                },
                {
                  "id": "be:East-Flanders",
                  "kind": "area",
                  "timeseries": 15
                },
                {
                  "id": "be:Flemish-Brabant",
                  "kind": "area",
                  "timeseries": 15
                },
                {
                  "id": "be:Limburg",
                  "kind": "area",
                  "timeseries": 15
                },
                {
                  "id": "be:West-Flanders",
                  "kind": "area",
                  "timeseries": 15
                }
              ]
            },
            {
              "id": "be:Wallonia",
              "kind": "area",
              "timeseries": 45,
              "children": [
                {
                  "id": "be:Hainaut",
                  "kind": "area",
                  "timeseries": 15
                },
                {
                  "id": "be:Liège",
                  "kind": "area",
                  "timeseries": 15
                },
                {
                  "id": "be:Luxembourg",
                  "kind": "area",
                  "timeseries": 15
                },
                {
                  "id": "be:Namur",
                  "kind": "area",
                  "timeseries": 15
                },
                {
                  "id": "be:Walloon-Brabant",
                  "kind": "area",
                  "timeseries": 15
                }
              ]
            },
            {
              "id": "sub:Zeebrugge",
              "kind": "substation",
              "timeseries": 0
            }
          ]
        }
      ]
    },
    {
      "id": "Bosnia_and_Herzegovina",
      "kind": "country",
      "name": "Bosnia and Herzegovina",
      "timeseries": 0,
      "children": [
        {
          "id": "BA",
          "kind": "price_zone",
          "timeseries": 39
        }
      ]
    },
    {
      "id": "Bulgaria",
      "kind": "country",
      "timeseries": 0,
      "children": [
        {
          "id": "BG",
          "kind": "price_zone",
          "timeseries": 137
        }
      ]
    },
    {
      "id": "Croatia",
      "kind": "country",
      "timeseries": 0,
      "children": [
        {
          "id": "HR",
          "kind": "price_zone",
          "timeseries": 132
        }
      ]
    },
    {
      "id": "Cyprus",
      "kind": "country",
      "timeseries": 0,
      "children": [
        {
          "id": "CY",
          "kind": "price_zone",
          "timeseries": 51
        }
      ]
    },
    {
      "id": "Czechia",
      "kind": "country",
      "timeseries": 0,
      "children": [
        {
          "id": "CZ",
          "kind": "price_zone",
          "timeseries": 89
        }
      ]
    },
    {
      "id": "DE-AT-LU",
      "kind": "price_zone",
      "timeseries": 0
    },
    {
      "id": "Denmark",
      "kind": "country",
      "timeseries": 35,
      "children": [
        {
          "id": "DK-DK1",
          "kind": "price_zone",
          "timeseries": 209,
          "children": [
            {
              "id": "sub:Revsing",
              "kind": "substation",
              "timeseries": 0
            }
          ]
        },
        {
          "id": "DK-DK2",
          "kind": "price_zone",
          "timeseries": 202
        }
      ]
    },
    {
      "id": "Estonia",
      "kind": "country",
      "timeseries": 0,
      "children": [
        {
          "id": "EE",
          "kind": "price_zone",
          "timeseries": 171
        }
      ]
    },
    {
      "id": "Finland",
      "kind": "country",
      "timeseries": 2,
      "children": [
        {
          "id": "FI",
          "kind": "price_zone",
          "timeseries": 272,
          "children": [
            {
              "id": "AX",
              "kind": "area",
              "timeseries": 0
            }
          ]
        }
      ]
    },
    {
      "id": "France",
      "kind": "country",
      "timeseries": 0,
      "children": [
        {
          "id": "FR",
          "kind": "price_zone",
          "timeseries": 191,
          "children": [
            {
              "id": "FR-COR",
              "kind": "area",
              "timeseries": 0
            },
            {
              "id": "sub:LesMandarins",
              "kind": "substation",
              "timeseries": 0
            },
            {
              "id": "sub:Peuplingues",
              "kind": "substation",
              "timeseries": 0
            },
            {
              "id": "sub:Tourbe",
              "kind": "substation",
              "timeseries": 0
            }
          ]
        }
      ]
    },
    {
      "id": "GB",
      "kind": "price_zone",
      "timeseries": 281,
      "children": [
        {
          "id": "bnd:GB-B1",
          "kind": "boundary",
          "timeseries": 3
        },
        {
          "id": "bnd:GB-B10",
          "kind": "boundary",
          "timeseries": 3
        },
        {
          "id": "bnd:GB-B11",
          "kind": "boundary",
          "timeseries": 3
        },
        {
          "id": "bnd:GB-B12",
          "kind": "boundary",
          "timeseries": 3
        },
        {
          "id": "bnd:GB-B13",
          "kind": "boundary",
          "timeseries": 3
        },
        {
          "id": "bnd:GB-B14",
          "kind": "boundary",
          "timeseries": 3
        },
        {
          "id": "bnd:GB-B15",
          "kind": "boundary",
          "timeseries": 3
        },
        {
          "id": "bnd:GB-B16",
          "kind": "boundary",
          "timeseries": 3
        },
        {
          "id": "bnd:GB-B17",
          "kind": "boundary",
          "timeseries": 3
        },
        {
          "id": "bnd:GB-B2",
          "kind": "boundary",
          "timeseries": 3
        },
        {
          "id": "bnd:GB-B3",
          "kind": "boundary",
          "timeseries": 3
        },
        {
          "id": "bnd:GB-B4",
          "kind": "boundary",
          "timeseries": 3
        },
        {
          "id": "bnd:GB-B5",
          "kind": "boundary",
          "timeseries": 3
        },
        {
          "id": "bnd:GB-B6",
          "kind": "boundary",
          "timeseries": 3
        },
        {
          "id": "bnd:GB-B7",
          "kind": "boundary",
          "timeseries": 3
        },
        {
          "id": "bnd:GB-B8",
          "kind": "boundary",
          "timeseries": 3
        },
        {
          "id": "bnd:GB-B9",
          "kind": "boundary",
          "timeseries": 3
        },
        {
          "id": "sub:Auchencrosh",
          "kind": "substation",
          "timeseries": 0
        },
        {
          "id": "sub:Bicker_Fen",
          "kind": "substation",
          "timeseries": 0
        },
        {
          "id": "sub:Cambois",
          "kind": "substation",
          "timeseries": 0
        },
        {
          "id": "sub:Daedalus",
          "kind": "substation",
          "timeseries": 0
        },
        {
          "id": "sub:Folkestone",
          "kind": "substation",
          "timeseries": 0
        },
        {
          "id": "sub:Grain",
          "kind": "substation",
          "timeseries": 0
        },
        {
          "id": "sub:Pembroke",
          "kind": "substation",
          "timeseries": 0
        },
        {
          "id": "sub:Richborough",
          "kind": "substation",
          "timeseries": 0
        },
        {
          "id": "sub:Sellindge",
          "kind": "substation",
          "timeseries": 0
        },
        {
          "id": "sub:Shotton",
          "kind": "substation",
          "timeseries": 0
        },
        {
          "id": "ta:GB-NGET",
          "kind": "area",
          "timeseries": 0,
          "children": [
            {
              "id": "gspg:GB-A",
              "kind": "area",
              "timeseries": 0
            },
            {
              "id": "gspg:GB-B",
              "kind": "area",
              "timeseries": 0
            },
            {
              "id": "gspg:GB-C",
              "kind": "area",
              "timeseries": 0
            },
            {
              "id": "gspg:GB-D",
              "kind": "area",
              "timeseries": 0
            },
            {
              "id": "gspg:GB-E",
              "kind": "area",
              "timeseries": 0
            },
            {
              "id": "gspg:GB-F",
              "kind": "area",
              "timeseries": 0
            },
            {
              "id": "gspg:GB-G",
              "kind": "area",
              "timeseries": 0
            },
            {
              "id": "gspg:GB-H",
              "kind": "area",
              "timeseries": 0
            },
            {
              "id": "gspg:GB-J",
              "kind": "area",
              "timeseries": 0
            },
            {
              "id": "gspg:GB-K",
              "kind": "area",
              "timeseries": 0
            },
            {
              "id": "gspg:GB-L",
              "kind": "area",
              "timeseries": 0
            },
            {
              "id": "gspg:GB-M",
              "kind": "area",
              "timeseries": 0
            }
          ]
        },
        {
          "id": "ta:GB-SHET",
          "kind": "area",
          "timeseries": 0,
          "children": [
            {
              "id": "gspg:GB-P",
              "kind": "area",
              "timeseries": 0
            }
          ]
        },
        {
          "id": "ta:GB-SPT",
          "kind": "area",
          "timeseries": 0,
          "children": [
            {
              "id": "gspg:GB-N",
              "kind": "area",
              "timeseries": 0
            }
          ]
        }
      ]
    },
    {
      "id": "Georgia",
      "kind": "country",
      "timeseries": 0,
      "children": [
        {
          "id": "GE",
          "kind": "price_zone",
          "timeseries": 20
        }
      ]
    },
    {
      "id": "Germany-Luxembourg",
      "kind": "country",
      "timeseries": 0,
      "children": [
        {
          "id": "DE-LU",
          "kind": "price_zone",
          "timeseries": 145,
          "children": [
            {
              "id": "DE",
              "kind": "area",
              "name": "Germany",
              "timeseries": 89,
              "children": [
                {
                  "id": "ca:DE-50Hertz",
                  "kind": "area",
                  "timeseries": 3
                },
                {
                  "id": "ca:DE-Amprion",
                  "kind": "area",
                  "timeseries": 3
                },
                {
                  "id": "ca:DE-TenneT",
                  "kind": "area",
                  "timeseries": 3
                },
                {
                  "id": "ca:DE-TransnetBW",
                  "kind": "area",
                  "timeseries": 3
                }
              ]
            },
            {
              "id": "LU",
              "kind": "area",
              "name": "Grand Duchy of Luxembourg",
              "timeseries": 44
            }
          ]
        }
      ]
    },
    {
      "id": "Greece",
      "kind": "country",
      "timeseries": 0,
      "children": [
        {
          "id": "GR",
          "kind": "price_zone",
          "timeseries": 78
        }
      ]
    },
    {
      "id": "Hungary",
      "kind": "country",
      "timeseries": 0,
      "children": [
        {
          "id": "HU",
          "kind": "price_zone",
          "timeseries": 114
        }
      ]
    },
    {
      "id": "Italy",
      "kind": "country",
      "timeseries": 87,
      "children": [
        {
          "id": "IT-CAL",
          "kind": "price_zone",
          "timeseries": 77
        },
        {
          "id": "IT-CNO",
          "kind": "price_zone",
          "timeseries": 80
        },
        {
          "id": "IT-CSO",
          "kind": "price_zone",
          "timeseries": 89
        },
        {
          "id": "IT-NO",
          "kind": "price_zone",
          "timeseries": 89
        },
        {
          "id": "IT-SAR",
          "kind": "price_zone",
          "timeseries": 81
        },
        {
          "id": "IT-SIC",
          "kind": "price_zone",
          "timeseries": 88
        },
        {
          "id": "IT-SO",
          "kind": "price_zone",
          "timeseries": 87
        }
      ]
    },
    {
      "id": "Kosovo",
      "kind": "country",
      "timeseries": 0,
      "children": [
        {
          "id": "XK",
          "kind": "price_zone",
          "timeseries": 12
        }
      ]
    },
    {
      "id": "Latvia",
      "kind": "country",
      "timeseries": 0,
      "children": [
        {
          "id": "LV",
          "kind": "price_zone",
          "timeseries": 124
        }
      ]
    },
    {
      "id": "Lithuania",
      "kind": "country",
      "timeseries": 0,
      "children": [
        {
          "id": "LT",
          "kind": "price_zone",
          "timeseries": 137
        }
      ]
    },
    {
      "id": "Moldova",
      "kind": "country",
      "timeseries": 0,
      "children": [
        {
          "id": "MD",
          "kind": "price_zone",
          "timeseries": 24
        }
      ]
    },
    {
      "id": "Montenegro",
      "kind": "country",
      "timeseries": 0,
      "children": [
        {
          "id": "ME",
          "kind": "price_zone",
          "timeseries": 22
        }
      ]
    },
    {
      "id": "Morocco",
      "kind": "country",
      "timeseries": 0,
      "children": [
        {
          "id": "MA",
          "kind": "price_zone",
          "timeseries": 0
        }
      ]
    },
    {
      "id": "NORDICS",
      "kind": "aggregate",
      "timeseries": 0
    },
    {
      "id": "Netherlands",
      "kind": "country",
      "timeseries": 0,
      "children": [
        {
          "id": "NL",
          "kind": "price_zone",
          "timeseries": 169,
          "children": [
            {
              "id": "sub:Maasvlakte",
              "kind": "substation",
              "timeseries": 0
            }
          ]
        }
      ]
    },
    {
      "id": "North_Macedonia",
      "kind": "country",
      "name": "North Macedonia",
      "timeseries": 0,
      "children": [
        {
          "id": "MK",
          "kind": "price_zone",
          "timeseries": 22
        }
      ]
    },
    {
      "id": "Norway",
      "kind": "country",
      "timeseries": 48,
      "children": [
        {
          "id": "NO-NO1",
          "kind": "price_zone",
          "timeseries": 174
        },
        {
          "id": "NO-NO2",
          "kind": "price_zone",
          "timeseries": 196,
          "children": [
            {
              "id": "sub:Kvilldal",
              "kind": "substation",
              "timeseries": 0
            }
          ]
        },
        {
          "id": "NO-NO3",
          "kind": "price_zone",
          "timeseries": 179
        },
        {
          "id": "NO-NO4",
          "kind": "price_zone",
          "timeseries": 168
        },
        {
          "id": "NO-NO5",
          "kind": "price_zone",
          "timeseries": 169
        }
      ]
    },
    {
      "id": "Poland",
      "kind": "country",
      "timeseries": 0,
      "children": [
        {
          "id": "PL",
          "kind": "price_zone",
          "timeseries": 214
        }
      ]
    },
    {
      "id": "Portugal",
      "kind": "country",
      "timeseries": 0,
      "children": [
        {
          "id": "PT",
          "kind": "price_zone",
          "timeseries": 78
        }
      ]
    },
    {
      "id": "Romania",
      "kind": "country",
      "timeseries": 0,
      "children": [
        {
          "id": "RO",
          "kind": "price_zone",
          "timeseries": 146
        }
      ]
    },
    {
      "id": "Russia",
      "kind": "country",
      "timeseries": 0,
      "children": [
        {
          "id": "RU-1",
          "kind": "price_zone",
          "timeseries": 0
        }
      ]
    },
    {
      "id": "SEM",
      "kind": "price_zone",
      "timeseries": 21,
      "children": [
        {
          "id": "GB-NIR",
          "kind": "area",
          "timeseries": 5,
          "children": [
            {
              "id": "sub:Ballycronanmore",
              "kind": "substation",
              "timeseries": 0
            }
          ]
        },
        {
          "id": "IE",
          "kind": "area",
          "name": "Ireland",
          "timeseries": 30,
          "children": [
            {
              "id": "sub:Great_Island",
              "kind": "substation",
              "timeseries": 0
            },
            {
              "id": "sub:Portan",
              "kind": "substation",
              "timeseries": 0
            }
          ]
        }
      ]
    },
    {
      "id": "Serbia",
      "kind": "country",
      "timeseries": 0,
      "children": [
        {
          "id": "RS",
          "kind": "price_zone",
          "timeseries": 69
        }
      ]
    },
    {
      "id": "Slovakia",
      "kind": "country",
      "timeseries": 0,
      "children": [
        {
          "id": "SK",
          "kind": "price_zone",
          "timeseries": 87
        }
      ]
    },
    {
      "id": "Slovenia",
      "kind": "country",
      "timeseries": 0,
      "children": [
        {
          "id": "SI",
          "kind": "price_zone",
          "timeseries": 55
        }
      ]
    },
    {
      "id": "Spain",
      "kind": "country",
      "timeseries": 0,
      "children": [
        {
          "id": "ES",
          "kind": "price_zone",
          "timeseries": 111
        }
      ]
    },
    {
      "id": "Sweden",
      "kind": "country",
      "timeseries": 38,
      "children": [
        {
          "id": "SE-SE1",
          "kind": "price_zone",
          "timeseries": 152
        },
        {
          "id": "SE-SE2",
          "kind": "price_zone",
          "timeseries": 155
        },
        {
          "id": "SE-SE3",
          "kind": "price_zone",
          "timeseries": 161
        },
        {
          "id": "SE-SE4",
          "kind": "price_zone",
          "timeseries": 155
        }
      ]
    },
    {
      "id": "Switzerland",
      "kind": "country",
      "timeseries": 0,
      "children": [
        {
          "id": "CH",
          "kind": "price_zone",
          "timeseries": 46
        }
      ]
    },
    {
      "id": "Turkey",
      "kind": "country",
      "timeseries": 0,
      "children": [
        {
          "id": "TR",
          "kind": "price_zone",
          "timeseries": 0
        }
      ]
    },
    {
      "id": "Ukraine",
      "kind": "country",
      "timeseries": 0,
      "children": [
        {
          "id": "UA",
          "kind": "price_zone",
          "timeseries": 0
        }
      ]
    },
    {
      "id": "sync:CESA",
      "kind": "sync_area",
      "timeseries": 0
    },
    {
      "id": "sync:NSA",
      "kind": "sync_area",
      "timeseries": 1
    }
  ]
}
{
  "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"
  ]
}