Skip to main content
GET
/
live
/
Get live electricity prices
curl --request GET \
  --url https://sandbox.prezio.eu/api/live/ \
  --header 'Authorization: <api-key>'
[
  {
    "count": 72,
    "context": {
      "currency": "DKK",
      "unit": "per_kwh",
      "interval_minutes": 60,
      "location": {
        "input_address": "Copenhagen, Denmark",
        "coordinates": {
          "latitude": 55.6867,
          "longitude": 12.5701,
          "confidence": 1
        }
      }
    },
    "tariff_elements": [
      {
        "element_id": "com_101",
        "element_name": "Grid Distribution Fee",
        "tariff_id": "tar_201",
        "tariff_name": "Residential Grid Tariff",
        "organization_id": "org_301",
        "organization_name": "Metropolitan DSO",
        "organization_type": "DSO"
      },
      {
        "element_id": "com_102",
        "element_name": "Spot Price",
        "tariff_id": "tar_202",
        "tariff_name": "Variable Energy Contract",
        "organization_id": "org_302",
        "organization_name": "Green Energy Retailer",
        "organization_type": "RET"
      },
      {
        "element_id": "com_103",
        "element_name": "Retailer Margin",
        "tariff_id": "tar_202",
        "tariff_name": "Variable Energy Contract",
        "organization_id": "org_302",
        "organization_name": "Green Energy Retailer",
        "organization_type": "RET"
      },
      {
        "element_id": "com_104",
        "element_name": "VAT 25%",
        "tariff_id": "tar_203",
        "tariff_name": "Standard VAT",
        "organization_id": "org_303",
        "organization_name": "Tax Authority",
        "organization_type": "TAX"
      }
    ],
    "results": [
      {
        "interval_start": "2024-01-15T00:00:00+01:00",
        "elements": [
          {
            "id": "com_101",
            "price": "0.085000"
          },
          {
            "id": "com_102",
            "price": "0.420000"
          },
          {
            "id": "com_103",
            "price": "0.045000"
          },
          {
            "id": "com_104",
            "price": "0.137500"
          }
        ],
        "interval_price": "0.687500"
      },
      {
        "interval_start": "2024-01-15T01:00:00+01:00",
        "elements": [
          {
            "id": "com_101",
            "price": "0.085000"
          },
          {
            "id": "com_102",
            "price": "0.380000"
          },
          {
            "id": "com_103",
            "price": "0.045000"
          },
          {
            "id": "com_104",
            "price": "0.127500"
          }
        ],
        "interval_price": "0.637500"
      }
    ]
  }
]

Authorizations

​
Authorization
string
header
required

Token-based authentication with required prefix "Token"

Query Parameters

​
address
string

Full address (required unless latitude/longitude are provided or location_id is used)

​
country
enum<string>

ISO-3166 alpha-2 country code of the requested location. Used to ensure geographic correctness.

Available options:
AT,
BE,
CH,
CZ,
DE,
DK,
EE,
ES,
FI,
FR,
GB,
GR,
HR,
HU,
IE,
IS,
IT,
LT,
LU,
LV,
NL,
NO,
PL,
PT,
RO,
SE,
SI,
SK
​
detail
enum<string>
default:full

Level of detail in response:

  • full: Returns all price elements (default)
  • semi: Returns prices per organization type (DSO, Retailer, etc.)
  • summarized: Returns only total prices
Available options:
full,
semi,
summarized
​
interval_minutes
enum<integer>

Time resolution in minutes. Must be 15, 30, or 60. If not provided, defaults to the tariff's spot price resolution, or 60 minutes if no spot prices exist.

Available options:
15,
30,
60
​
latitude
number

Latitude coordinate (required unless address is provided or location_id is used)

​
location_id
string

ID of a saved Location object. When provided, the location's configured tariffs are always used (any tariff_id parameter is ignored). Also overrides country/address/coordinates.

​
longitude
number

Longitude coordinate (required unless address is provided or location_id is used)

​
tariff_id
string[]

Tariff ID. Can be repeated for multiple tariffs. Required only when location_id is not used.

​
vat
enum<string>
default:excluded

How to handle VAT:

  • excluded: VAT Excluded (default)
  • included: VAT included in each component
  • separated: VAT returned as a separate component
Available options:
excluded,
included,
separated

Response

OK

​
count
integer
required

Number of results

Example:

5

​
context
object
required
​
meta
object
required

Serializer for response metadata including warnings and spot price info

​
links
object
required

Serializer for navigation links to valid days (prev/next only, excluding current day)

​
tariff_elements
object[]
required
​
results
object[]
required