Historical Measurements for Systems

Lists aggregated measurements of a system over a period of time.

System measurements are the result of incorporating measurements from
all appliances that are part of a system. This allows computing e.g.
overall consumption adding producers (e.g. PV) and subtracting consumers
(e.g. EV charging stations). This aggregation is performed in various
resolutions to suit different use cases. See the 'resolution' parameter
for a list of options.

Depending on the resolution parameter, the response contains either
power or energy measurements (unless otherwise documented):

  • 10m, 15m, 1h: power (unit: W)
  • 1d, 1w, 1M, 1y: energy (unit: Wh)

Measurements are "aligned" differently whether they contain energy or
power measurements:

  • For power values the data point is written after the aggregated time
    span. For the interval 2018-04-01T00:00:00Z/2018-04-02T00:00:00Z
    with resolution 10m the first observation will be recorded at
    2018-04-01T00:10:00Z
  • For energy values the observation is stored at the beginning of
    the aggregated time span. For the interval
    2018-04-01T00:00:00Z/2018-04-05T00:00:00Z and resolution 1h the first
    observation will be recorded at 2018-04-01T00:00:00Z

The total object of the response contains an aggregation of the
individual data points over time and therefore is an energy value.
The total.measuredAt field is an interval containing all data points
in the requested interval.

In order to reduce the duration of the endpoint, the gridX API imposes
limitations on the interval for a given resolution:

ResolutionLimit
10mintervals up to 1 day
15mintervals up to 1 day
1hintervals up to 1 week
1dintervals up to 1 month
1wintervals up to 1 month
1Mintervals up to 5 years
1yno limit
Recipes
⬇️
Export system measurements
Open Recipe
Language
Authentication
Bearer
JWT
Click Try It! to start a request and see the response here!