v1

latestOpenAPI 3.0.02026-07-263365201.7 KB

Prices

Retrieve a price time series

Retrieve a price object for a given subscription. For a consumption subscription this is the variable price time series the customer pays and can optimize consumption against; for a feed-in subscription it is the payout the customer is credited per kWh, based on EPEX day-ahead spot prices and without grid fees. All prices are inclusive of VAT, except feed-in payouts to a VAT-exempt customer.

get/subscriptions/{id}/prices

Path parameters

idstring required

Example:sub_1

Query parameters

startstring required

Start date of the period at 00:00:00 in local time of the customer (format yyyy-mm-dd)

Example:2025-02-01

Start date of the period at 00:00:00 in local time of the customer (format yyyy-mm-dd)

endstring required

End date of the period at 23:59:59 in local time of the customer (format yyyy-mm-dd)

Example:2025-02-01

End date of the period at 23:59:59 in local time of the customer (format yyyy-mm-dd)

Response

Retrieve the price details

object'price' required

subscriptionstring required

The id of the subscription

unitstring required

The unit of the price

currencystring required

The currency of the price

resolution'hourly' | '15min' required

The time resolution of the price data points

referencestring required

Reference market for electricity prices

Example response

{
  "subscription": "sub_rocbrf1u5e48mm0reeqoag90",
  "period": {
    "start": "2025-04-01",
    "end": "2025-04-01"
  },
  "unit": "ct/kWh",
  "currency": "EUR",
  "resolution": "hourly",
  "reference": "EPEX Day-Ahead Hourly",
  "items": [
    {
      "timestamp": "2024-01-31T00:00:00Z",
      "amount": 24.44,
      "components": [
        {
          "type": "electricity",
          "amount": 8.77
        },
        {
          "type": "grid",
          "amount": 9.47
        },
        {
          "type": "levies",
          "amount": 6.2
        }
      ]
    },
    {
      "timestamp": "2024-01-31T01:00:00Z",
      "amount": 22.15,
      "components": [
        {
          "type": "electricity",
          "amount": 7.48
        },
        {
          "type": "grid",
          "amount": 9.47
        },
        {
          "type": "levies",
          "amount": 5.2
        }
      ]
    },
    {
      "timestamp": "2024-01-31T02:00:00Z",
      "amount": 20.88,
      "components": [
        {
          "type": "electricity",
          "amount": 6.21
        },
        {
          "type": "grid",
          "amount": 9.47
        },
        {
          "type": "levies",
          "amount": 5.2
        }
      ]
    },
    {
      "timestamp": "2024-01-31T03:00:00Z",
      "amount": 19.97,
      "components": [
        {
          "type": "electricity",
          "amount": 5.3
        },
        {
          "type": "grid",
          "amount": 9.47
        },
        {
          "type": "levies",
          "amount": 5.2
        }
      ]
    },
    {
      "timestamp": "2024-01-31T04:00:00Z",
      "amount": 21.56,
      "components": [
        {
          "type": "electricity",
          "amount": 6.89
        },
        {
          "type": "grid",
          "amount": 9.47
        },
        {
          "type": "levies",
          "amount": 5.2
        }
      ]
    }
  ]
}