Price a session at a public charger
What one charging session costs at one public charging location, from the operator's OCPI tariff incl. 21% VAT. Every kind of EVSE at the location (AC or DC, power, tariff) gets its own price, cheapest first. stay_minutes longer than the charge counts as idle time, which some operators bill as parking time. Each option also carries parking for the whole stay, from the base tariff the area registers (day cards are left out), and total_incl_vat_eur: charging plus parking, or null when a part is unknown. Any personal token may read it.
API token from the Joulo dashboard, or an OAuth2 access token.
In: header
Query Parameters
The operator's party id, from GET /public-chargers.
^[A-Za-z0-9]{2,3}$The location id, from GET /public-chargers.
length <= 64How many kWh the car charges.
1 <= value <= 150The car's charging power in kW. Default 11 on AC and 50 on DC, never more than the EVSE.
1 <= value <= 400A clock time (19:00, the next time it comes around in Amsterdam) or an ISO date-time within 31 days. Default now.
How long the car stays plugged in. Default: only the charging time.
1 <= value <= 1440Response Body
curl -X GET "https://api.joulo.nl/functions/v1/api/public-chargers/price?party_id=string&location_id=string&kwh=1&kw=1&start=string&stay_minutes=1"{
"location": {
"party_id": "NUO",
"location_id": "b8c78986af3b981a1dcf58a8cc5ce949",
"name": null,
"address": "Oude Kerkstraat 28A",
"postal_code": "5525 AV",
"city": "Duizel",
"operator": "Vattenfall InCharge",
"distance_m": 120,
"parking_type": "ON_STREET",
"open_24_7": true,
"evses": 2,
"available": 1,
"charging": 1,
"out_of_order": 0,
"unknown": 0,
"power_types": [
"AC"
],
"max_power_kw": 11.04,
"plugs": [
"IEC_62196_T2"
],
"reference_price": {
"status": "ok",
"kwh": 12,
"incl_vat_eur": 5.88,
"per_kwh_incl_vat_eur": 0.4903
},
"tariff_text": "Per kWh: 0.49 EUR"
},
"session": {
"kwh": 11,
"start_local": "2026-11-03 14:00",
"stay_minutes": 240
},
"options": [
{
"power_type": "AC",
"max_power_kw": 11.04,
"evses": 2,
"available": 1,
"charging_kw": 11,
"charging_minutes": 60,
"idle_minutes": 180,
"price": {
"status": "ok",
"incl_vat_eur": 19.91,
"per_kwh_incl_vat_eur": 1.81,
"breakdown_incl_vat_eur": {
"flat": 0,
"energy": 5.39,
"time": 0,
"parking": 14.52
}
},
"stay_too_short": false
}
],
"notes": [
"Prices incl. 21% VAT, from the operator's published tariff."
]
}{
"error": "invalid_kwh",
"detail": "kwh runs from 1 to 150."
}{
"error": "unknown_location",
"detail": "No active public charging location with this id."
}