experimental

Energy history

Changed on

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

get/history/energy

Request

  • Base URL
    https://demo.evcc.io/api
  • URL
    https://demo.evcc.io/api/history/energy
  • Auth
    none declared

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

titlestring

Entity title, omitted when grouped

group'pv' | 'battery' | 'grid' | 'loadpoint' | 'consumer' | 'meter' | 'home' | 'forecast' | 'temperature'
isTempboolean

socTemp values are temperatures, not state of charge

Changes

  • 7f2e5fedb37aRevision changes
    • breaking

      the response's body type changed from object to array for status

  • bde8e5f8c6e6Revision changes
    • info

      added the new optional query request parameter group

    • info

      added the new optional query request parameter name

    • info

      added the new optional query request parameter title