JouloDocs

List chargers

Returns all chargers linked to your account, including current status, active charging session details, and the latest meter reading.

GET
/chargers
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/chargers"
{
  "chargers": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "nickname": "Garage",
      "connection_type": "easee",
      "status": "online",
      "mid_certified": true,
      "is_charging": true,
      "current_session": {
        "id": "f0e1d2c3-b4a5-6789-0abc-def123456789",
        "started_at": "2026-04-09T08:15:00Z",
        "kwh_so_far": 12.45
      },
      "latest_meter_wh": 5432100,
      "meter_updated_at": "2026-04-09T10:30:00Z"
    },
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "nickname": "Oprit",
      "connection_type": "ocpp",
      "status": "online",
      "mid_certified": false,
      "is_charging": false
    }
  ]
}
{
  "error": "Missing or invalid API token"
}
{
  "error": "Insufficient scope",
  "required_scope": "chargers:read"
}