---
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

## Changes

- **2026-07-01** `bde8e5f8c6e6` — 3 info
  - added the new optional `query` request parameter `group`
  - added the new optional `query` request parameter `name`
  - added the new optional `query` request parameter `title`
- **2026-06-06** `0e65ec723370` — 1 info
  - endpoint added
- **2025-08-01** `2429e9297a5c` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/evcc-io/apis/evcc/changes/history/energy/get.md)

---

[API](https://skmtc.dev/evcc-io/apis/evcc.md) · [All operations](https://skmtc.dev/evcc-io/apis/evcc/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/evcc-io/evcc/revisions/5152af83a070/schema)