JouloDocs

List chargers

Returns all chargers linked to your account, including current status, active charging session details, and the latest meter reading. A charger that does not count for ERE carries help_url, the kennisbank article on MID meters. A charger without a live view (charging_state: unknown) carries docs_url, the manual for its brand.

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",
      "brand": "Zaptec",
      "model": "Go 2",
      "connection_type": "cloud_api",
      "status": "active",
      "mid_certified": true,
      "mid_eligible": true,
      "is_charging": true,
      "charging_state": "charging",
      "power_kw": 10.8,
      "last_energy_at": "2026-04-09T10:30:00Z",
      "docs_url": "https://joulo.nl/docs/zaptec",
      "connection_status": "online",
      "last_seen_at": "2026-04-09T10:29:12Z",
      "last_seen_basis": "device",
      "current_session": {
        "id": "f0e1d2c3-b4a5-6789-0abc-def123456789",
        "started_at": "2026-04-09T08:15:00Z",
        "kwh_so_far": 12.45,
        "meter_start_wh": null,
        "id_tag": "04A1B2C3D4E5F6",
        "estimated_euro": 1.49
      },
      "latest_meter_wh": 5432100,
      "meter_updated_at": "2026-04-09T10:30:00Z"
    },
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "nickname": "Oprit",
      "brand": "Alfen",
      "model": null,
      "connection_type": "ocpp",
      "status": "active",
      "mid_certified": false,
      "mid_eligible": false,
      "is_charging": false,
      "charging_state": "unknown",
      "power_kw": null,
      "last_energy_at": null,
      "help_url": "https://joulo.nl/kennisbank/heeft-mijn-laadstation-een-mid-meter",
      "docs_url": "https://joulo.nl/docs/alfen",
      "connection_status": "unreachable",
      "last_seen_at": "2026-04-08T21:04:55Z",
      "last_seen_basis": "device",
      "connection_help_url": "https://joulo.nl/kennisbank/laadstation-zonder-internet",
      "access": {
        "managed_by": "joulo",
        "choice": "no_tag",
        "chosen_by": "owner",
        "charger_setting": "tag"
      }
    }
  ]
}
{
  "error": "Missing or invalid API token"
}
{
  "error": "Insufficient scope",
  "required_scope": "chargers:read"
}