---
title: "Aggregated electricity prices"
method: GET
path: "/api/v1/aggregated-data/aggregated-prices"
tags: ["Aggregated Data"]
---

# Aggregated electricity prices

`GET /api/v1/aggregated-data/aggregated-prices`

Retrieves aggregated electricity prices between two dates with specified granularity.

## Query parameters

- `from` string, date-time, required
- `to` string, date-time, required
- `cubeeSNs` string[]
- `granularity` string, required

## Response `200`

OK

- AggregatedPriceResultModel
  - `from` string, date-time — The start of the requested period for aggregated prices, including date and time in UTC.
  - `to` string, date-time — The end of the requested period for aggregated prices, including date and time in UTC.
  - `periods` AggregatedPricePeriodModel[], nullable — List of aggregated price periods within the specified date range, based on the chosen granularity (e.g., daily, monthly).
    - `date` string, date — The date representing this aggregated price period.
    - `totalBuyEnergyMWh` number, double, nullable — Total amount of energy (in MWh) bought from the grid by all households during this period.
    - `totalBuyFullPrice` number, double, nullable — Total amount paid by all households combined for the energy bought, including all fees and taxes. Currency is specified in the parent model.
    - `totalBuyPowerPrice` number, double, nullable — Total amount paid by all households combined for the energy bought, covering only the commodity energy price ("silová elektřina" in Czech) and excluding regulated parts and taxes. Currency is specified in the parent model.
    - `totalSellEnergyMWh` number, double, nullable — Total amount of energy (in MWh) sold to the grid by all households during this period.
    - `totalSellFullPrice` number, double, nullable — Total amount received by all households combined for the energy sold, including all fees and taxes. Currency is specified in the parent model.
    - `totalSellPowerPrice` number, double, nullable — Total amount received by all households combined for the energy sold, covering only the commodity energy price ("silová elektřina" in Czech) and excluding regulated parts and taxes. Currency is specified in the parent model.
  - `currency` string, nullable — The currency in which the prices are expressed, following the ISO 4217 currency codes. Default is "CZK".

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.dev/cubee/apis/partner-api.md) · [All operations](https://skmtc.dev/cubee/apis/partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cubee/partner-api/revisions/d5db975189bb/schema)