Grid limitation sessions

GET

/gridsessions

const url = 'https://demo.evcc.io/api/gridsessions?format=csv&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/gridsessions?format=csv&lang=de'

Returns a list of HEMS grid limitation events.

Parameters

Query Parameters

format

string

Allowed values: csv

Response format (default json)

lang

string

Example

de

Language (defaults to accept header)

Responses

200

Success

object

result

Grid limitation sessions

Array<object>

object

Loadpoint index starting at 1.

integer

>= 1

created

Timestamp in RFC3339 format

string format: date-time

finished

Timestamp in RFC3339 format

string format: date-time

type

Type of grid limitation event

string

Allowed values: consumption feedin

gridPower

Grid power in watts

number

limitPower

Limitation power in watts

number

chargeDuration

Duration of active charging

number

solarPercentage

Solar percentage of the session

number

price

Total price of the session

number

pricePerKWh

Average price per kWh

number

co2PerKWh

Average CO₂ emissions per kWh

number

Example

{
  "result": [
    {
      "id": 1,
      "created": "2025-07-19T12:30:00.000Z",
      "finished": "2025-07-19T12:30:00.000Z",
      "type": "consumption"
    }
  ]
}