---
title: "Energy history"
method: GET
path: "/history/energy"
tags: ["experimental"]
---

# Energy history

`GET /history/energy`

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

## Query parameters

- `from` string, date-time
- `to` string, date-time
- `aggregate` string
- `grouped` boolean
- `group` 'forecast' | 'battery' | 'grid' | 'pv' | 'home' | 'loadpoint' | 'meter' | 'consumer'
- `name` string
- `title` string
- `format` 'json' | 'csv'
- `lang` string

## Response `200`

Energy history data

- object

## Other responses

- `400` — Invalid parameters or database offline

---

[API](https://skmtc.net/evcc-io/apis/evcc.md) · [All operations](https://skmtc.net/evcc-io/apis/evcc/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/evcc-io/evcc/versions/1d484c790b11/schema)