JouloDocs

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.

GET
/ere-position
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).

Range2026 <= value

Response 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"
}