v33

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-03722657.7 KB
experimental

Energy history

Returns aggregated energy history data. Aggregate granularity defaults to 15 minutes. Supports CSV export.

get/history/energy

Query parameters

fromstring date-time
Example:2026-07-01T00:00:00Z

Start time (RFC3339)

tostring date-time
Example:2026-07-02T00:00:00Z

End time (RFC3339)

aggregatestring
Example:1h

Aggregation interval. Examples: 15m, 1h, day, month

groupedboolean

Group results by loadpoint

group'forecast' | 'battery' | 'grid' | 'pv' | 'home' | 'loadpoint' | 'meter' | 'consumer'
Example:battery

Filter by entity group

namestring
Example:db:8

Filter by entity name

titlestring
Example:Battery

Filter by entity title

format'json' | 'csv'
Example:json

Response format

langstring
Example:de

Language for CSV column headers (BCP 47, e.g. de, en). Defaults to Accept-Language header.

Response

Energy history data

object required