Sessions
Understand charging session data in Joulo
A session represents a single charging event • from the moment your car starts drawing power until it stops. Every session records how much energy was delivered and, when applicable, how many ERE-credits were earned.
Session object
{
"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": 14.10
}Fields
| Field | Type | Description |
|---|---|---|
id | string (UUID) | Unique identifier for the session. |
charger_id | string (UUID) | ID of the charger this session belongs to. |
charger_nickname | string | User-defined name of the charger. |
started_at | string (ISO 8601) | When the session started. |
ended_at | string (ISO 8601) | When the session ended. null for active sessions. |
kwh | number | Total energy delivered, in kilowatt-hours. |
status | string | active, charging, or completed. |
ere_credits | number | ERE-credits earned by this session (count, not euros). Derived from kwh via the NEa formula (see below). null for sessions with zero kWh. |
Session statuses
| Status | Description |
|---|---|
active | The charger is connected and a session is in progress. |
charging | The charger is actively delivering power. |
completed | The session has ended and final energy values are recorded. |
Energy calculation
Joulo calculates kwh from the best available data source for each session:
- Direct kWh value from the charger (if reported)
- Energy in watt-hours, converted to kWh
- Difference between meter start and stop readings
- Live meter reading minus meter start (for active sessions)
This ensures accurate energy values regardless of which charger brand you use.
ERE-credits
ERE stands for Emissiereductie-eenheden (Emission Reduction Units) — the official unit under the Dutch RED III implementation. The ere_credits field is the count of ERE generated by this session, derived deterministically from kwh:
ere_credits = kwh × 0.505 × 0.65880.505— Dutch grid renewable fraction for 2026 (CBS).0.6588— RED III fossil reference (183 g CO₂eq/MJ × 3.6 MJ/kWh).
Only sessions on a MID-certified charger are eligible to be inboeked at the NEa. The API returns ere_credits for every session regardless — apply your own MID filter (GET /chargers, field mid_certified) if you only want eligible sessions.
To convert to euros, multiply by the current market price per ERE and apply the platform fee:
euro = ere_credits × ere_price_mid × (1 − effective_fee_pct/100)ere_price_mid and effective_fee_pct are exposed by GET /me so a client can reproduce the exact net amount that /dashboard shows.
Filtering sessions
The GET /sessions endpoint supports several query parameters:
charger_id• Show sessions for a specific charger onlyfrom/to• Filter by date range (ISO 8601 timestamps)limit/offset• Paginate through results
See the API reference for full details.