Discover
Entity
Authorization
apiKey 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.
Query Parameters
geo?boolean
Add the polygon (areas) or the line (cables). Not implemented in this iteration (ignored).
Default
falseResponse Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://grid.rebase.energy/api/v1/entities/string"{
"id": "SE-SE3",
"kind": "price_zone",
"name": "SE3",
"parent": {
"id": "Sweden",
"kind": "country",
"timeseries": 31
},
"country": "Sweden",
"sync_area": "sync:NSA",
"children": [
{
"kind": "plant",
"count": 720,
"capacity_mw": 14473,
"with_timeseries": 0,
"list": "/entities/SE-SE3/plants"
}
],
"relations": [
{
"id": "border:FI~SE-SE3",
"kind": "border",
"to": "Finland",
"between": [
"FI",
"SE-SE3"
],
"positive": "FI → SE-SE3",
"interconnectors": [],
"timeseries": {
"total": 4,
"providers": {
"fingrid": 3,
"entsoe": 1
},
"categories": {
"exchange": 4
}
}
},
{
"id": "border:AX~SE-SE3",
"kind": "border",
"to": "Finland",
"between": [
"AX",
"SE-SE3"
],
"positive": "AX → SE-SE3",
"interconnectors": [],
"timeseries": {
"total": 1,
"providers": {
"fingrid": 1
},
"categories": {
"exchange": 1
}
}
},
{
"id": "border:SE-SE3~SE-SE4",
"kind": "border",
"to": "Sweden",
"between": [
"SE-SE3",
"SE-SE4"
],
"positive": "SE-SE3 → SE-SE4",
"interconnectors": [],
"timeseries": {
"total": 1,
"providers": {
"entsoe": 1
},
"categories": {
"exchange": 1
}
}
},
{
"id": "border:SE-SE2~SE-SE3",
"kind": "border",
"to": "Sweden",
"between": [
"SE-SE2",
"SE-SE3"
],
"positive": "SE-SE2 → SE-SE3",
"interconnectors": [],
"timeseries": {
"total": 1,
"providers": {
"entsoe": 1
},
"categories": {
"exchange": 1
}
}
},
{
"id": "border:DK-DK1~SE-SE3",
"kind": "border",
"to": "Denmark",
"between": [
"DK-DK1",
"SE-SE3"
],
"positive": "DK-DK1 → SE-SE3",
"interconnectors": [],
"timeseries": {
"total": 5,
"providers": {
"entsoe": 5
},
"categories": {
"exchange": 5
}
}
},
{
"id": "border:NO-NO1~SE-SE3",
"kind": "border",
"to": "Norway",
"between": [
"NO-NO1",
"SE-SE3"
],
"positive": "NO-NO1 → SE-SE3",
"interconnectors": [],
"timeseries": {
"total": 1,
"providers": {
"entsoe": 1
},
"categories": {
"exchange": 1
}
}
}
],
"timeseries": {
"total": 55,
"providers": {
"entsoe": 39,
"esett": 13,
"svk": 2,
"kraftnat": 1
},
"categories": {
"price": 18,
"production": 10,
"balancing": 11,
"consumption": 11,
"capacity": 5
}
}
}{
"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"
]
}