Nieuw in de API: je volledige ERE-positie opvragen

In je Joulo-dashboard zie je al hoeveel ERE je opbouwt en wat daar ongeveer voor uitbetaald wordt. Sinds deze week kun je diezelfde cijfers ook rechtstreeks uit de API halen. Het nieuwe endpoint GET /ere-position geeft je volledige ERE-positie voor een compliance-jaar terug, tot op kwartaalniveau.

Handig als je je verdiensten in een eigen dashboard, een spreadsheet of Home Assistant wilt tonen, zonder in te loggen.

Wat je terugkrijgt

Per compliance-jaar splitst het endpoint je ERE op in vier statussen:

• paid • al verkocht én uitbetaald
• payable • verkocht, staat klaar voor de eerstvolgende kwartaaluitbetaling
• reserved • toegewezen aan een verkoopbatch, nog niet afgerekend
• unsold • nog niet verkocht, met een prognose die is opgesplitst in year-to-date en de rest van het jaar

Daarnaast krijg je een quarters-array: per kwartaal hoeveel ERE je produceerde, hoeveel daarvan al verkocht is en tegen welke gerealiseerde prijs. Dat is dezelfde reserve/sell/forecast-weergave als in het dashboard.

Waarom per kwartaal

Joulo verkoopt ERE in batches op de markt, via brokers. De prijs die je uiteindelijk krijgt is de gerealiseerde marktprijs op het moment van verkoop, geen vaste garantie, en die settelt per kwartaal. Daarom zie je in de response zowel een richtprijs (indicative_price_per_ere) als de gerealiseerde gemiddelde prijs (realized_avg_price). De richtprijs voor een huishouden ligt netto rond €0,12 tot €0,15 per kWh; onze 20% servicekosten zijn in de net_eur-bedragen al verrekend.

Een ingekorte response ziet er zo uit:

{
 "compliance_year": 2026,
 "effective_fee_pct": 20,
 "indicative_price_per_ere": 0.451,
 "realized_avg_price": 0.462,
 "paid": { "ere": 120.0, "net_eur": 44.35, "price_per_ere": 0.462 },
 "payable": { "ere": 40.0, "net_eur": 14.78, "price_per_ere": 0.462 },
 "reserved": { "ere": 60.0, "net_eur": 22.12, "price_per_ere": 0.461 },
 "unsold": { "ere": 92.45, "forecast_net_eur": 33.36 },
 "total_expected_eur": 114.61,
 "quarters": [
 { "quarter": "2026 Q1", "ere": 150.0, "sold_ere": 150.0, "price_per_ere": 0.55 },
 { "quarter": "2026 Q2", "ere": 162.45, "sold_ere": 70.0, "price_per_ere": 0.52 }
 ]
}

Met de query-parameter ?year= vraag je een specifiek jaar op. Zonder parameter krijg je het huidige kalenderjaar.

Voorbeeld: je verwachte opbrengst in Home Assistant

Wil je je verwachte jaaropbrengst als sensor in Home Assistant, dan is dit genoeg:

rest:
 - resource: https://api.joulo.nl/functions/v1/api/ere-position
 headers:
 Authorization: !secret joulo_api_token
 scan_interval: 3600
 sensor:
 - name: "Joulo ERE verwacht"
 value_template: "{{ value_json.total_expected_eur }}"
 unit_of_measurement: "EUR"
 device_class: monetary

Eén keer per uur pollen is ruim voldoende; de positie verandert hooguit per verkoopbatch. Meer voorbeelden staan in de Home Assistant-gids.

Aan de slag

Je maakt een persoonlijk API-token aan in je dashboard en stuurt dat mee als Authorization: Bearer <token>. Het endpoint valt onder de scope position:read. De volledige responsestructuur staat in de API-referentie.

Vragen of feedback op de API? Laat het ons weten via contact. We bouwen de developer-tooling stap voor stap uit.