Energy
Monthly energy aggregates and lifetime statistics in Joulo
The energy endpoint provides a high-level view of your charging activity • monthly breakdowns and lifetime totals. The headline fields count only sessions on MID-eligible chargers — the same filter as the dashboard top line, since only those sessions produce ERE. The *_all fields cover every charger on your account.
Energy statistics object
{
"total_kwh": 2847.52,
"total_ere_credits": 947.21,
"total_sessions": 186,
"total_kwh_all": 3102.18,
"total_sessions_all": 203,
"months": [
{
"month": "2026-04",
"kwh": 124.30,
"ere_credits": 41.36,
"sessions": 8,
"kwh_all": 139.12,
"sessions_all": 9
},
{
"month": "2026-03",
"kwh": 387.45,
"ere_credits": 128.88,
"sessions": 22,
"kwh_all": 402.83,
"sessions_all": 24
}
]
}Top-level fields
| Field | Type | Description |
|---|---|---|
total_kwh | number | Lifetime energy charged on MID-eligible chargers, in kWh • matches the dashboard top line. |
total_ere_credits | number | Lifetime total Emissiereductie-eenheden (ERE count, MID-eligible chargers only), derived from kwh via the NEa formula. Multiply by ere_price_mid from GET /me and (1 − effective_fee_pct/100) to get net euros. |
total_sessions | number | Lifetime number of charging sessions on MID-eligible chargers. |
total_kwh_all | number | Lifetime energy charged across every charger (including non-MID), in kWh. |
total_sessions_all | number | Lifetime number of charging sessions across every charger. |
months | array | Monthly breakdown, sorted newest first. |
Monthly fields
| Field | Type | Description |
|---|---|---|
month | string | Month in YYYY-MM format. |
kwh | number | Energy charged on MID-eligible chargers in this month, in kWh. |
ere_credits | number | ERE count for the month (MID-eligible chargers only): kwh × 0.505 × 0.6588 (NL renewable fraction × RED III reduction factor). |
sessions | number | Number of charging sessions on MID-eligible chargers in this month. |
kwh_all | number | Energy charged across every charger in this month, in kWh. |
sessions_all | number | Number of charging sessions across every charger in this month. |
ERE position
Where the energy object tells you how many ERE you generate, the GET /ere-position endpoint tells you what happens to them commercially for a given compliance year • how much is already sold and paid out, reserved, still payable, and the forecast value of what is still unsold.
Joulo sells ERE in batches on the market, so your realised price differs from the indicative one and settles per quarter. The response splits your position into paid, payable, reserved and unsold (with a year-to-date vs. rest-of-year forecast), plus a quarters array with the ERE produced and the ERE sold per quarter • the same reserve/sell/forecast view as the dashboard. Pass ?year= to look at a specific compliance year (defaults to the current one).
See the ERE position reference for the full response shape.