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.
AuthorizationBearer <token>
API token from the Joulo dashboard, or an OAuth2 access token.
In: header
Query Parameters
year?integer
Compliance year (defaults to the current calendar year).
Range
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,
"allocatable_ere": 312.45,
"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,
"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,
"ytd_expected_eur": 114.61,
"total_expected_eur": 114.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"
}