Energy history

GET

/history/energy

const 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';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

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)

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

One series per entity, or per group when grouped

Array<object>

object

title

Entity title, omitted when grouped

string

group

string

Allowed values: pv battery grid loadpoint consumer meter home forecast temperature

isTemp

SocTemp values are temperatures, not state of charge

boolean

data

Array<object>

object

start

string format: date-time

end

string format: date-time

energy

KWh

number

returnEnergy

KWh exported or discharged

number

socTemp

State of charge in percent or temperature of a single slot

number

cost

Grid import cost, where a price exists

number

pricedEnergy

KWh imported where a price exists

number

returnCost

Grid export revenue, where a price exists

number

pricedReturnEnergy

KWh exported where a price exists

number

Example

[
  {
    "group": "pv"
  }
]

400

Invalid parameters or database offline