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,
DE,
DK,
ES,
GB,
NO,
SE
​
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>
default:60

Time resolution in minutes. Must be 15, 30, or 60. Defaults to 60 (hourly).

Available options:
15,
30,
60
​
latitude
number

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

​
location_id
integer

ID of a saved Location object. If provided, overrides country/address/coordinates.

​
longitude
number

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

​
tariff_id
string[]
required

Tariff ID with tar_ prefix (e.g., tar_123). Can be repeated for multiple tariffs.

​
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
​
links
object
required

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

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