JouloDocs

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 across all your chargers.

Energy statistics object

{
  "total_kwh": 2847.52,
  "total_ere_credits": 947.21,
  "total_sessions": 186,
  "months": [
    {
      "month": "2026-04",
      "kwh": 124.30,
      "ere_credits": 41.36,
      "sessions": 8
    },
    {
      "month": "2026-03",
      "kwh": 387.45,
      "ere_credits": 128.88,
      "sessions": 22
    }
  ]
}

Top-level fields

FieldTypeDescription
total_kwhnumberLifetime total energy charged across all chargers, in kWh.
total_ere_creditsnumberLifetime total Emissiereductie-eenheden (ERE count), 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_sessionsnumberLifetime total number of charging sessions.
monthsarrayMonthly breakdown, sorted newest first.

Monthly fields

FieldTypeDescription
monthstringMonth in YYYY-MM format.
kwhnumberTotal energy charged in this month, in kWh.
ere_creditsnumberTotal ERE count for the month: kwh × 0.505 × 0.6588 (NL renewable fraction × RED III reduction factor).
sessionsnumberNumber of charging sessions completed in this month.

Use cases

Next steps