---
title: "Tariff history"
method: GET
path: "/history/tariffs"
tags: ["experimental"]
---

# Tariff history

`GET /history/tariffs`

## Request

- Base URL: `https://demo.evcc.io/api`
- URL: `https://demo.evcc.io/api/history/tariffs`
- Auth: none declared

Returns the persisted 15 minute tariff slots in the period, or their averages per hour, day or month.

## Query parameters

- `aggregate` '15m' | 'hour' | 'day' | 'month'
- `from` string, date-time
- `to` string, date-time

## Response `200`

Tariff slots

- object[]
  - `start` string, date-time
  - `grid` number: Grid price per kWh, the bucket average when aggregated
  - `gridMin` number: Lowest slot price in the bucket, aggregated only
  - `gridMax` number: Highest slot price in the bucket, aggregated only
  - `feedin` number: Grid export price per kWh, the bucket average when aggregated
  - `feedinMin` number
  - `feedinMax` number
  - `co2` number: g/kWh
  - `temperature` number: °C

## Other responses

- `400`: Invalid parameters or database offline

## Changes

- **2026-10-05** `7f2e5fedb37a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/evcc-io/apis/evcc/changes/history/tariffs/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.dev/evcc-io/apis/evcc/revisions/f6589b1a9e51?raw)