Get what charging cost
What your charging cost over a period, per session from the EPEX price of each moment: on a dynamic contract with your supplier, on your own fixed tariff (only when you entered one and your contract is not dynamic), and with smart charging. The same sums as the cost card in the dashboard. priced_share below 1 means part of the kWh had no price, so the costs are a lower bound. ere.value_eur is the indicative ERE value of the kWh on stations that count. session_list holds the newest 100 sessions; the totals cover all of them. Default period: the last 30 days, at most 366 days. Requires the profile:read scope.
API token from the Joulo dashboard, or an OAuth2 access token.
In: header
Query Parameters
A date (start of that day in Amsterdam) or an ISO date-time.
A date (end of that day in Amsterdam) or an ISO date-time.
Response Body
curl -X GET "https://api.joulo.nl/functions/v1/api/costs?from=2026-09-01&to=2026-09-30"{
"from": "2026-08-31T22:00:00.000Z",
"to": "2026-09-30T22:00:00.000Z",
"contract": {
"type": "dynamic",
"supplier": "Tibber",
"own_fixed_eur_per_kwh": null
},
"sessions": 38,
"kwh": 350.7,
"priced_share": 0.902,
"dynamic_cost_eur": 109.07,
"dynamic_avg_eur_per_kwh": 0.311,
"fixed_cost_eur": null,
"smart": {
"sessions": 34,
"dynamic_cost_eur": 99.22,
"smart_cost_eur": 91.86,
"saving_eur": 7.36
},
"your_cost_eur": 109.07,
"ere": {
"eligible_kwh": 350.7,
"net_eur_per_kwh": 0.1093,
"value_eur": 38.33,
"indicative": true
},
"your_cost_after_ere_eur": 70.74,
"session_list": [
{
"session_id": "f61a024a-8b12-438f-bc09-ef7cb9940c0c",
"charger_id": "de01f434-60b4-4ea6-96c6-b16020c51a16",
"started_at": "2026-09-30T18:24:42+00:00",
"ended_at": "2026-10-01T06:39:44+00:00",
"kwh": 14.4,
"dynamic_cost_eur": 5.26,
"smart_cost_eur": 5.1,
"fixed_cost_eur": null,
"priced_share": 1,
"counts_for_ere": true
}
],
"session_list_truncated": false
}{
"error": "connection_type is required and must be \"ocpp\""
}{
"error": "Missing or invalid API token"
}{
"error": "Insufficient scope",
"required_scope": "chargers:read"
}