JouloDocs
Api referenceEnergy

Find public chargers near a place

Public charging locations in the Netherlands around a place, nearest first, from NDW, the national data portal for road traffic, which publishes the charging data. Each location has its EVSE status counts, highest power, plugs and a reference price: 12 kWh on AC at up to 11 kW, or 30 kWh on DC at up to 50 kW, starting at 14:00, incl. 21% VAT. A reference price with status unknown means the operator publishes no price, never that charging is free. Each location also carries parking: the garage, lot or paid street zone the charger belongs to, from the parking tariffs that municipalities and garage operators register (open data), with the cost of two hours from now on the base tariff. Status is up to a day old. Give place or lat and lng. Any personal token may read it. With kwh (and stay_minutes) the answer ranks the locations by session_cost.total_incl_vat_eur: charging plus parking for the whole stay, cheapest first. A token with profile:read also gets home: the same kWh charged at the user's own home before the next 07:00 on their own contract, with the indicative ERE when their home laadstation counts.

GET
/public-chargers
AuthorizationBearer <token>

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

In: header

Query Parameters

place?string

A postcode, an address or a town in the Netherlands. Instead of lat and lng.

Lengthlength <= 100
lat?number

Latitude in the Netherlands.

Range50.6 <= value <= 53.7
lng?number

Longitude in the Netherlands.

Range3.2 <= value <= 7.3
radius_m?integer

Search radius in metres.

Default1000
Range50 <= value <= 10000
power_type?string

AC or DC. Leave it out for both.

Value in"AC" | "DC"
max_results?integer

How many locations, nearest first.

Default10
Range1 <= value <= 20
shapes?string

1 to also return parking_areas: the parking areas behind these locations (at most 50), each with its simplified shape and the cost of two hours from now. For a map.

Value in"1" | "true"
kwh?number

Rank by this session: how many kWh the car charges. The locations are then sorted by charging plus parking for the stay, cheapest first, and each gets session_cost.

Range1 <= value <= 150
stay_minutes?integer

With kwh: how long the car stays parked. Parking and the operator's idle fee count for the whole stay. Default: only the charging time.

Range1 <= value <= 1440
start?string

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

Response Body

curl -X GET "https://api.joulo.nl/functions/v1/api/public-chargers?place=string&lat=50.6&lng=3.2&radius_m=1000&power_type=AC&max_results=10&shapes=1&kwh=1&stay_minutes=1&start=string"
{
  "place": "postcode 5525, Duizel",
  "radius_m": 1000,
  "data_as_of": "2026-11-03T09:58:00+00:00",
  "count": 1,
  "locations": [
    {
      "party_id": "NUO",
      "location_id": "b8c78986af3b981a1dcf58a8cc5ce949",
      "name": null,
      "address": "Oude Kerkstraat 28A",
      "postal_code": "5525 AV",
      "city": "Duizel",
      "operator": "Vattenfall InCharge",
      "distance_m": 120,
      "lat": 51.368172,
      "lng": 5.293911,
      "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"
    }
  ],
  "notes": [
    "Prices are the ad-hoc prices the operator publishes, incl. 21% VAT. A charge card can cost more or less."
  ]
}
{
  "error": "invalid_radius",
  "detail": "radius_m runs from 50 to 10000."
}
{
  "error": "unknown_place",
  "detail": "No place in the Netherlands matches this postcode, address or town."
}