Skip to content
Docs
EN | DE

Charging sessions

GET
/sessions
 
curl --request GET \
  --url 'https://demo.evcc.io/api/sessions?format=csv&lang=de&month=2&year=2025'

Returns a list of charging sessions.

More information

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
format
string
Allowed values: csv

Response format (default json)

lang
string
Example 
de

Language (defaults to accept header)

month
integer
>= 1 <= 12
Example 
2

Month filter

year
integer
Example 
2025

Year filter

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Success

object
result

Charging sessions

Array<object>
object
id

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
loadpoint

More information

string
vehicle

More information

string
>= 1 characters /[a-zA-Z0-9_.:-]+/
odometer

Vehicle odometer reading in kilometers

number
nullable
meterStart

Meter reading at start of charging session

number
nullable
meterStop

Meter reading at end of charging session

number
nullable
chargedEnergy

Charged energy in kWh

number
Example 
{
  "result": [
    {
      "id": 1,
      "created": "2025-07-19T12:30:00.000Z",
      "finished": "2025-07-19T12:30:00.000Z",
      "loadpoint": "Garage",
      "vehicle": "vehicle_1"
    }
  ]
}