Energy flow

GET

/history/flow

const url = 'https://demo.evcc.io/api/history/flow?from=2026-07-01T00%3A00%3A00Z&to=2026-07-02T00%3A00%3A00Z';
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/flow?from=2026-07-01T00%3A00%3A00Z&to=2026-07-02T00%3A00%3A00Z'

Returns the energy attributed from sources (pv, battery, grid) to sinks (home, battery, loadpoint, export) over the period, plus grid cost and CO2 sums where tariff data exists.

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)

Responses

200

Energy flow data

application/json

object

flows

Array<object>

object

from

string

Allowed values: pv battery grid

string

Allowed values: home battery loadpoint export

energy

KWh

number

cost

Cost of the energy, for home and loadpoint

number

pricedEnergy

KWh where a price exists

number

cost

Grid cost sums, omitted without grid price data

object

import

number

export

number

importEnergy

KWh where a price exists

number

exportEnergy

KWh where a price exists

number

avgGrid

number

co2

Grid CO2 sums in kg, omitted without CO2 data

object

consumption

Emissions of the grid share that went to home and loadpoints

number

consumptionEnergy

KWh

number

baseline

number

avgCo2

G/kWh

number

Example

{
  "flows": [
    {
      "from": "pv",
      "to": "home"
    }
  ]
}

400

Invalid parameters or database offline