Get ERE reserve/sell/forecast position
Returns your ERE position for a compliance year: expected yearly revenue, reserved, payable and paid amounts, the unsold forecast (year-to-date plus rest-of-year projection), and a per-quarter breakdown. Mirrors the reserve/sell/forecast tab in the dashboard. blocked explains a forecast of 0 while the quarters show production: reason names the first step that is still missing before Joulo can sell that ERE (registration, mandate, ean, review or iban), ere and forecast_net_eur belong to that reason, and by_reason lists every reason with its ERE. review waits on Joulo; the other four are actions for the user in the dashboard. unsold.ere includes a projection to the end of the year when forecast_is_projected is true: unsold.produced_ere is the unsold ERE of sessions that already happened, unsold.projected_ere the projected rest. blocked.help gives per blocked reason a help_url (the kennisbank article that explains it) and an action_url (the dashboard tab where you complete it), or null where there is none.
API token from the Joulo dashboard, or an OAuth2 access token.
In: header
Query Parameters
Compliance year (defaults to the current calendar year).
2026 <= valueResponse Body
curl -X GET "https://api.joulo.nl/functions/v1/api/ere-position?year=2026"{
"compliance_year": 2026,
"effective_fee_pct": 20,
"indicative_price_per_ere": 0.451,
"year_ere": 312.45,
"allocatable_ere": 312.45,
"allocatable_kwh": 939.3,
"pending_ere": 8.32,
"pending_kwh": 25,
"pending_sessions": 2,
"pending_forecast_net_eur": 3,
"pending_ready_at": "2026-08-25T09:10:40.917+00:00",
"blocked": {
"reason": null,
"ere": 0,
"forecast_net_eur": 0,
"by_reason": {},
"help": {}
},
"realized_avg_price": 0.462,
"paid": {
"ere": 120,
"net_eur": 44.35,
"price_per_ere": 0.462
},
"payable": {
"ere": 40,
"net_eur": 14.78,
"price_per_ere": 0.462
},
"reserved": {
"ere": 60,
"net_eur": 22.12,
"price_per_ere": 0.461
},
"unsold": {
"ere": 92.45,
"produced_ere": 92.45,
"projected_ere": 0,
"forecast_net_eur": 33.36,
"ytd_ere": 92.45,
"ytd_forecast_net_eur": 33.36,
"future_ere": 0,
"future_forecast_net_eur": 0
},
"forecast_confidence": "high",
"forecast_is_projected": true,
"forecast_history_days": 214,
"forecast_rate_floored": false,
"forecast_pace_total_eur": null,
"ytd_expected_eur": 117.61,
"total_expected_eur": 117.61,
"quarters": [
{
"quarter": "2026 Q1",
"ere": 150,
"sold_ere": 150,
"price_per_ere": 0.55
},
{
"quarter": "2026 Q2",
"ere": 162.45,
"sold_ere": 70,
"price_per_ere": 0.52
}
]
}{
"error": "Missing or invalid API token"
}{
"error": "Insufficient scope",
"required_scope": "chargers:read"
}