Energy history

GET

/history/energy

curl --request GET \
  --url 'https://demo.evcc.io/api/history/energy?from=2026-07-01T00%3A00%3A00Z&to=2026-07-02T00%3A00%3A00Z&aggregate=15m&grouped=false&group=forecast&name=db%3A8&title=Battery&format=json&lang=de'

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

Parameters

Query Parameters

from

string format: date-time

Example

2026-07-01T00:00:00Z

Start time (RFC3339)

to

string format: date-time

Example

2026-07-02T00:00:00Z

End time (RFC3339)

aggregate

string

default: 15m

Example

1h

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

grouped

boolean

Example

false

Group results by loadpoint

group

string

Allowed values: forecast battery grid pv home loadpoint meter consumer

Example

battery

Filter by entity group

name

string

Example

db:8

Filter by entity name

title

string

Example

Battery

Filter by entity title

format

string

default: json

Allowed values: json csv

Example

json

Response format

lang

string

Example

de

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

Responses

200

Energy history data

object

Example^generated

{}

string

400

Invalid parameters or database offline