Platformcijfers feed

Publiek JSON- en CSV-endpoint met de platformcijfers van Joulo • MID-kWh en ERE's van dit jaar, klanten, app-installaties, en de verdeling over merken en koppelroutes als aandeel in procent

Dezelfde cijfers als op joulo.nl/status en de homepage, als open feed met een vaste, kleine sleutellijst. Geen apikey, geen account • gewoon een GET. Alle open datasets staan bij elkaar op joulo.nl/open-data.

Endpoints

GET https://joulo.nl/api/platform-cijfers        # JSON
GET https://joulo.nl/api/platform-cijfers.csv    # CSV, één rij met de losse cijfers

CORS is open (Access-Control-Allow-Origin: *). Cache-Control: public, max-age=3600, s-maxage=86400 • de cijfers verversen één keer per dag, net als op de site. Beide antwoorden dragen een Link: <https://creativecommons.org/licenses/by/4.0/>; rel="license"-header en een X-Attribution-header met de citeerregel.

Licentie en citeerregel

De dataset staat onder Creative Commons Attribution 4.0 (CC BY 4.0). Je mag de data kopiëren, bewerken en verspreiden, ook commercieel en ook in een AI-antwoord, zolang je de bron noemt:

Bron: Joulo, platformcijfers (joulo.nl/status), CC BY 4.0

Response (JSON)

{
  "ok": true,
  "source": "https://joulo.nl/status",
  "docs": "https://developer.joulo.nl/guides/platform-cijfers-feed",
  "csv": "https://joulo.nl/api/platform-cijfers.csv",
  "license": {
    "id": "CC-BY-4.0",
    "name": "Creative Commons Attribution 4.0 International",
    "url": "https://creativecommons.org/licenses/by/4.0/"
  },
  "attribution": "Joulo (joulo.nl)",
  "citation": "Bron: Joulo, platformcijfers (joulo.nl/status), CC BY 4.0",
  "fields": [
    { "key": "date", "provenance": "administratie", "description": "Dag waarop dit snapshot is gemaakt (YYYY-MM-DD)." }
  ],
  "generated_at": "2026-09-25T10:00:00.000Z",
  "date": "2026-09-25",
  "year": 2026,
  "annual_kwh_forecast": 41688990,
  "kwh_measured": 24800648,
  "measured_through": "2026-09-25T07:03:00+00:00",
  "annual_ere_forecast": 13869677,
  "customers_min": 22500,
  "app_installs": 25500,
  "app_rating_ios": 4.75,
  "app_rating_ios_count": 444,
  "app_rating_android": 4.64,
  "app_rating_android_count": 145,
  "auto_connected_pct": 94,
  "cpo_tenants_live": 7,
  "inboekdienstverlener_tenants": 2,
  "brands": [
    { "brand": "Zaptec", "share_pct": 30.75 },
    { "brand": "Easee", "share_pct": 10.5 }
  ],
  "connections": { "cloud_api": 76.4, "ocpp": 17.45, "cloud": 3.21, "upload": 2.57, "manual": 0.26, "sap_meter": 0.02 },
  "infra_mix": { "cloud_integrations": 72.35, "ocpp": 17.45, "cpo_platforms": 7.29, "upload": 2.57, "manual": 0.26 }
}

Velden en herkomst

Veld	Herkomst	Betekenis
`date`	administratie	Dag van het snapshot. De feed ververst één keer per dag.
`year`	administratie	Kalenderjaar waar de kWh- en ERE-prognose over gaan.
`annual_kwh_forecast`	afgeleid	Prognose MID-gemeten kWh voor het hele jaar: gemeten tot vandaag plus verwacht volume tot 31 december, over thuisladen, zakelijk, VvE en CPO-netwerken.
`kwh_measured`	meting	MID-gemeten kWh in het jaar tot `measured_through`.
`measured_through`	administratie	Tot welk moment `kwh_measured` loopt.
`annual_ere_forecast`	afgeleid	ERE's uit de kWh-prognose: `kWh × 0,505 × 0,6588`.
`customers_min`	afgeleid	Klanten, naar boven afgerond op 500. Lees als "N+". Particulier, zakelijk en white-label samen.
`app_installs`	bron	Installaties van de Joulo-app, iOS en Android samen, uit de stores.
`app_rating_ios`, `app_rating_ios_count`	bron	Gemiddelde beoordeling en aantal beoordelingen in de App Store.
`app_rating_android`, `app_rating_android_count`	bron	Gemiddelde beoordeling en aantal beoordelingen in Google Play.
`auto_connected_pct`	afgeleid	Aandeel laadstations met een automatische koppeling (cloud-API, OCPP of platform), in procent.
`cpo_tenants_live`	administratie	Aantal white-label CPO-omgevingen dat live is.
`inboekdienstverlener_tenants`	administratie	Aantal inboekdienstverleners dat op de Joulo-software draait.
`brands`	afgeleid	Verdeling van gekoppelde laadstations over merken, als aandeel in procent, aflopend. Alleen JSON.
`connections`	afgeleid	Verdeling over koppelroutes als aandeel in procent. Alleen JSON.
`infra_mix`	afgeleid	Verdeling over infrastructuur (cloud-integraties, OCPP, CPO-platforms, upload, handmatig) als aandeel in procent. Alleen JSON.

Aantallen laadstations en laadsessies publiceert Joulo niet, ook niet per merk. Elke verdeling staat daarom als aandeel in procent en het klantaantal alleen naar boven afgerond. Wil je meer, dan is de ERE-opbrengst feed of het verkooplogboek meestal wat je zoekt.

CSV

Eén rij met de losse cijfers, kolommen in de volgorde van de tabel hierboven zonder de drie verdelingen. Komma als scheidingsteken, punt als decimaalteken, UTF-8, regeleinde \r\n.

curl -s https://joulo.nl/api/platform-cijfers.csv

Voorbeelden

curl

curl https://joulo.nl/api/platform-cijfers | jq '{kwh: .annual_kwh_forecast, ere: .annual_ere_forecast, klanten: .customers_min}'

JavaScript (fetch)

const res = await fetch("https://joulo.nl/api/platform-cijfers");
const d = await res.json();
console.log(`${d.year}: ${d.annual_kwh_forecast.toLocaleString("nl-NL")} kWh (prognose), ${d.customers_min}+ klanten`);

Foutgevallen

De endpoint geeft altijd HTTP 200 terug. Bij een upstream-fout staat ok: false in het lichaam; check dus op ok, niet op de statuscode.

Bronvermelding

De feed is vrij te gebruiken onder CC BY 4.0 met de citeerregel hierboven. Vragen over een cijfer? Mail [email protected].

On this page