List sessions
Returns a paginated list of charging sessions. Use query parameters to filter by charger, date range, and to control pagination.
AuthorizationBearer <token>
API token from the Joulo dashboard, or an OAuth2 access token.
In: header
Query Parameters
limit?integer
Number of sessions to return. Maximum 100.
Default
20Range
1 <= value <= 100offset?integer
Number of sessions to skip for pagination.
Default
0Range
0 <= valuecharger_id?string
Filter sessions to a specific charger by its ID.
Format
uuidfrom?string
Only return sessions that started on or after this ISO 8601 timestamp.
Format
date-timeto?string
Only return sessions that started on or before this ISO 8601 timestamp.
Format
date-timeResponse Body
curl -X GET "https://api.joulo.nl/functions/v1/api/sessions?limit=20&offset=0&charger_id=497f6eca-6276-4993-bfeb-53cbbbba6f08&from=2019-08-24T14%3A15%3A22Z&to=2019-08-24T14%3A15%3A22Z"{
"sessions": [
{
"id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
"charger_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"charger_nickname": "Garage",
"started_at": "2026-04-08T18:30:00Z",
"ended_at": "2026-04-09T06:45:00Z",
"kwh": 42.37,
"status": "completed",
"ere_credits": 6.36
},
{
"id": "d4e5f6a7-b8c9-0123-defa-234567890123",
"charger_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"charger_nickname": "Garage",
"started_at": "2026-04-07T20:15:00Z",
"ended_at": "2026-04-08T05:30:00Z",
"kwh": 38.91,
"status": "completed",
"ere_credits": 5.84
}
],
"limit": 20,
"offset": 0
}{
"error": "Missing or invalid API token"
}{
"error": "Insufficient scope",
"required_scope": "chargers:read"
}