JouloDocs

Get energy statistics

Returns monthly energy aggregates and lifetime totals for all chargers on your account.

GET
/energy
AuthorizationBearer <token>

API token from the Joulo dashboard, or an OAuth2 access token.

In: header

Response Body

curl -X GET "https://api.joulo.nl/functions/v1/api/energy"
{
  "total_kwh": 2847.52,
  "total_ere_credits": 427.13,
  "total_sessions": 186,
  "months": [
    {
      "month": "2026-04",
      "kwh": 124.3,
      "ere_credits": 18.65,
      "sessions": 8
    },
    {
      "month": "2026-03",
      "kwh": 387.45,
      "ere_credits": 58.12,
      "sessions": 22
    }
  ]
}
{
  "error": "Missing or invalid API token"
}
{
  "error": "Insufficient scope",
  "required_scope": "chargers:read"
}