JouloDocs
Api referenceEnergy

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.

GET
/public-chargers/price
AuthorizationBearer <token>

API token from the Joulo dashboard, or an OAuth2 access token.

In: header

Query Parameters

party_idstring

The operator's party id, from GET /public-chargers.

Match^[A-Za-z0-9]{2,3}$
location_idstring

The location id, from GET /public-chargers.

Lengthlength <= 64
kwhnumber

How many kWh the car charges.

Range1 <= value <= 150
kw?number

The car's charging power in kW. Default 11 on AC and 50 on DC, never more than the EVSE.

Range1 <= value <= 400
start?string

A clock time (19:00, the next time it comes around in Amsterdam) or an ISO date-time within 31 days. Default now.

stay_minutes?integer

How long the car stays plugged in. Default: only the charging time.

Range1 <= value <= 1440

Response 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."
}