Energy
Day-ahead electricity price forecasts collected from ENTSO-E — see docs/architecture/energy-price-forecast-roadmap.md. Public market data: a raw zone= query needs no organization context, only a valid bearer token.
3 endpoints
Lists day-ahead price forecast points for a bidding zone, chronological.
get/v1/energy/pricesRequires a bearer token
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| zone | query | string | A raw ENTSO-E bidding zone EIC code (required). |
| environment_id | query | string<uuid> | No longer accepted — kept only so its presence (with or without
zone) can be detected and rejected, rather than silently ignored
as an unknown query parameter. |
| from | query | string<date-time> | Defaults to now. |
| to | query | string<date-time> | Defaults to from + 48h. |
Responses
| Status | Body | Description |
|---|---|---|
| 200 | ListPricesResponse | Day-ahead price forecast points for the bidding zone, chronological |
| 400 | ErrorBody | zone was not given, or to is not after from; environment_id is no longer accepted |
| 401 | ErrorBody | Missing, invalid, or expired bearer token |
Lists every bidding zone the platform collects day-ahead prices for — the whole `energy::KNOWN_BIDDING_ZONES` list, in its declared order, no pagination or filtering. Untenanted reference data (per `specs/052-web-site-settings/research.md`'s authorization decision), so any authenticated caller gets the full list.
get/v1/energy/zonesRequires a bearer token
Responses
| Status | Body | Description |
|---|---|---|
| 200 | — | Every bidding zone the platform collects prices for |
| 401 | ErrorBody | Missing, invalid, or expired bearer token |
Lists day-ahead price forecast points for a site's configured bidding zone, chronological.
get/v1/sites/{site_id}/energy/pricesRequires a bearer token
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| site_id* | path | string<uuid> | Site id |
| from | query | string<date-time> | Defaults to now. |
| to | query | string<date-time> | Defaults to from + 48h. |
Responses
| Status | Body | Description |
|---|---|---|
| 200 | ListPricesResponse | Day-ahead price forecast points for the site's configured bidding zone, chronological |
| 400 | ErrorBody | to is not after from |
| 401 | ErrorBody | Missing, invalid, or expired bearer token |
| 404 | ErrorBody | No site with this id exists, the caller cannot access it, or it has no price zone configured |