Quick start
Make your first Joulo API call in under 5 minutes
Follow these steps to authenticate and fetch your charger data from the Joulo API.
Get your API token
Log in to the Joulo dashboard and navigate to Settings → API. Click Activate to generate your personal API token. Copy it — you can reveal it later from the same page.
List your chargers
Call GET /chargers to see all chargers linked to your account.
curl https://api.joulo.nl/functions/v1/api/chargers \
-H "Authorization: Bearer YOUR_API_TOKEN"import requests
response = requests.get(
"https://api.joulo.nl/functions/v1/api/chargers",
headers={"Authorization": "Bearer YOUR_API_TOKEN"},
)
print(response.json())const response = await fetch("https://api.joulo.nl/functions/v1/api/chargers", {
headers: {
Authorization: "Bearer YOUR_API_TOKEN",
},
});
const data = await response.json();
console.log(data);Interpret the response
A successful request returns a list of your chargers with their current status:
{
"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"
}
]
}| Field | Description |
|---|---|
id | Unique identifier for the charger. |
nickname | The name you gave the charger in the Joulo app. |
connection_type | How the charger connects to Joulo (e.g. easee, ocpp). |
is_charging | Whether the charger has an active session right now. |
current_session | Details of the active session, if any. |
If the chargers array is empty, you haven't connected any chargers yet. Add one from the Joulo dashboard.
Next steps
- Charging sessions — Understand session data and query history.
- Energy statistics — Get monthly and lifetime energy totals.
- Home Assistant — Integrate Joulo into your smart home.
- API reference — Browse all endpoints and response schemas.