ERE-verkooplogboek feed

Publiek JSON-endpoint met alle gerealiseerde ERE-verkopen van Joulo • datum, broker, volume, gerealiseerde prijs per ERE en status

Joulo publiceert elke ERE-verkoop openbaar op joulo.nl/ere-verkopen. Dezelfde data is beschikbaar als open JSON-feed. Geen apikey, geen account • gewoon een GET. Bedoeld voor pers, vergelijkers en iedereen die onze cijfers uit de eerste hand wil citeren in plaats van ze te reconstrueren.

Endpoint

GET https://joulo.nl/api/ere-verkopen

CORS is open (Access-Control-Allow-Origin: *). Cache-Control: public, max-age=900, s-maxage=900 • verkopen wijzigen hooguit een paar keer per kwartaal, dus 15 minuten cachen is ruim vers.

Response

{
  "ok": true,
  "source": "https://joulo.nl/ere-verkopen",
  "docs": "https://developer.joulo.nl/guides/ere-verkopen-feed",
  "attribution": "Joulo (joulo.nl)",
  "generated_at": "2026-07-23T10:00:00.000Z",
  "sales": [
    {
      "sale_month": "2026-07",
      "sale_date": "2026-07-06",
      "trade_ref": "20260629S00298",
      "broker": "SFI Green Markets B.V.",
      "vintage": 2026,
      "product_code": "LRE-Energy",
      "status": "agreed",
      "invoiced_date": null,
      "settled_date": null,
      "paid_date": null,
      "delivery_start": "2026-10-01",
      "delivery_end": "2026-12-31",
      "payment_terms_days": 5,
      "early_discount_eur_per_ere": 0.01,
      "price_eur_per_ere": 0.481,
      "quarters": "Q2 2026",
      "volume_mln_ere": 1.0,
      "gross_eur_per_kwh": 0.16,
      "paid_month": null
    }
  ]
}

sales is aflopend gesorteerd (nieuwste verkoop eerst).

Velden

Veld	Betekenis
`sale_date`	Datum waarop de verkoop is overeengekomen.
`trade_ref`	Confirmatie-referentie van de broker • maakt de regel naslagbaar.
`broker`	Broker via wie de verkoop liep.
`vintage`	Compliance-jaar van de verkochte ERE's.
`product_code`	Productcategorie op de confirmatie (`LRE-Energy` = elektriciteit, wegvervoer).
`status`	`agreed` → `invoiced` → `settled` → `paid`, met bijbehorende `*_date`-velden.
`delivery_start` / `delivery_end`	Levervenster uit de confirmatie.
`payment_terms_days`	Betaaltermijn van de koper in werkdagen.
`early_discount_eur_per_ere`	Korting voor vervroegde uitbetaling (€ 0,01 per ERE per kwartaal eerder), al verrekend in `price_eur_per_ere`.
`price_eur_per_ere`	Gerealiseerde verkoopprijs per ERE.
`quarters`	Laadkwartaal waaruit de verkochte kWh komen (bv. `"Q1 2026"`).
`volume_mln_ere`	Volume in miljoenen ERE, afgerond op 0,1 mln.
`gross_eur_per_kwh`	De prijs per ERE omgerekend per thuisgeladen kWh (× 0,33269 ERE/kWh), vóór servicekosten.
`paid_month`	Maand van uitbetaling; `null` zolang de verkoop niet is afgewikkeld.

Tegenpartij, marge en klantaantallen per verkoop zijn bewust niet openbaar. De feed bevat ook bewust géén netto-bedragen voor klanten: de servicefee verschilt per klant en contract (particulier, zakelijk, energiepartner, kortingen), dus een netto-bedrag bij één aangenomen fee zou misleiden.

Voorbeelden

curl

curl https://joulo.nl/api/ere-verkopen | jq '.sales[0].price_eur_per_ere'

JavaScript (fetch)

const res = await fetch("https://joulo.nl/api/ere-verkopen");
const { sales } = await res.json();
console.log(`Laatste verkoop: €${sales[0].price_eur_per_ere}/ERE (${sales[0].sale_date})`);

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 met bronvermelding: Joulo (joulo.nl). Vragen over de data of een specifieke verkoop? Mail [email protected] (Head of Trade) of [email protected].

On this page