Power Forecast

Query power generation forecast data for renewable energy sources (Solar, Wind, etc.).

Query power forecast data

post

Query power forecast prediction data for renewable energy generation (Solar, Wind, etc.).

Dimensions:

• zone_key: Country/region code (e.g. "DE")

• psr_type: Generation source type (e.g. "Solar", "Wind Onshore")

Query Modes (mutually exclusive):

1. Horizon mode (init_time-centric):

   • init_time: Specific init time(s) or relative tokens (latest, latest-N)

   • max_prediction_timedelta: Limit forecast horizon (minutes)

2. Time range mode (time-centric):

   • start_time / end_time: Filter by computed forecast time

Response Formats:

• json: Columnar JSON format {column: [values], ...}

• arrow: Apache Arrow IPC stream for efficient processing

Authentication: Requires API key.

Authorizations

HTTPBearer

Query parameters

formatstring · enumOptional

Response format: 'json' or 'arrow'

Default: jsonPossible values:

include_unitsbooleanOptional

When true, JSON responses are wrapped in {data, units}. Units are always sent via X-Variable-Units header regardless.

Default: false

Body

application/json

Query parameters for power forecast data.

Supports two mutually exclusive query modes:

Horizon mode (init_time-centric): - Specify init_time as datetime(s) or relative tokens (latest/latest-N) - Optionally limit by max_prediction_timedelta

Time range mode (time-centric): - Specify start_time / end_time - Computed time = init_time + prediction_timedelta * 60s

Common filters: - zone_keys: List of zone codes (e.g. ["DE", "FR"]) - psr_types: List of generation types (e.g. ["Solar", "Wind Onshore"])

zone_keysany ofOptional

List of zone codes (e.g. ['DE', 'FR'])

Example: ["DE"]

string[]Optional

or

nullOptional

psr_typesany ofOptional

List of PSR types (e.g. ['Solar', 'Wind Onshore'])

Example: ["Solar","Wind Onshore"]

string[]Optional

or

nullOptional

init_timeany ofOptional

Init time selection for horizon mode. Accepts datetime(s), 'latest', or 'latest-N'.

Example: latest

integerOptional

Offset from latest forecast (0 = latest, 1 = second latest, etc.)

or

string · date-timeOptional

or

or

nullOptional

max_prediction_timedeltaany ofOptional

Maximum prediction horizon in minutes (horizon mode)

integerOptional

or

nullOptional

start_timeany ofOptional

Start of time range (inclusive, time range mode)

Example: 2025-12-01T00:00:00Z

string · date-timeOptional

or

nullOptional

end_timeany ofOptional

End of time range (exclusive, time range mode)

Example: 2025-12-07T00:00:00Z

string · date-timeOptional

or

nullOptional

time_zoneany ofOptional

IANA time zone name for time formatting (e.g. 'Europe/Berlin')

Example: UTC

stringOptional

or

nullOptional

order_byany ofOptional

Columns to order by. Supports direction suffix: 'time__desc' for descending. Default: time ASC.

Example: ["time","zone_key"]

or

nullOptional

paginationany ofOptional

Pagination parameters

or

nullOptional

Responses

200

Successfully retrieved power forecast data

application/jsonapplication/vnd.apache.arrow.stream

400

Invalid query parameters

401

Authentication required

403

Insufficient permissions

422

Validation Error

application/json

post

/v1/power-forecast/data

HTTPcURLJavaScriptPython

POST /v1/power-forecast/data HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 63

{
  "zone_keys": [
    "DE"
  ],
  "psr_types": [
    "Solar"
  ],
  "init_time": "latest"
}

Latest solar forecast for GermanySpecific init time with horizonTime range query

{
  "zone_key": [
    "DE",
    "DE"
  ],
  "psr_type": [
    "Solar",
    "Solar"
  ],
  "init_time": [
    "2025-12-01T00:00:00Z",
    "2025-12-01T00:00:00Z"
  ],
  "prediction_timedelta": [
    60,
    120
  ],
  "time": [
    "2025-12-01T01:00:00Z",
    "2025-12-01T02:00:00Z"
  ],
  "value": [
    1250.5,
    1320.3
  ]
}

List available power forecast zones

get

Get a list of available zone codes that have power forecast data.

This is a metadata endpoint and does not require authentication.

Responses

200

Successfully retrieved zone list

application/json

get

/v1/power-forecast/zones

HTTPcURLJavaScriptPython

GET /v1/power-forecast/zones HTTP/1.1
Accept: */*

200

Successfully retrieved zone list

{
  "zones": [
    "DE"
  ]
}

List available PSR types

get

Get a list of available PSR (Production Source) types for power forecasts.

This is a metadata endpoint and does not require authentication.

Query parameters

zone_keyany ofOptional

Optional zone key to filter PSR types by

stringOptional

or

nullOptional

Responses

200

Successfully retrieved PSR type list

application/json

422

Validation Error

application/json

get

/v1/power-forecast/psr-types

HTTPcURLJavaScriptPython

GET /v1/power-forecast/psr-types HTTP/1.1
Accept: */*

{
  "psr_types": [
    "Solar",
    "Wind Onshore"
  ]
}

List available init times

get

Get available forecast init times with their max prediction horizon.

Used by the dashboard to populate the init_time dropdown when creating a power forecast data source. Results are ordered newest-first.

This is a metadata endpoint and does not require authentication.

Query parameters

zone_keyany ofOptional

Zone key to filter init times by

stringOptional

or

nullOptional

psr_typeany ofOptional

PSR type(s) to filter by. When multiple are given, only init_times available for ALL of them are returned.

string[]Optional

or

nullOptional

limitinteger · min: 1 · max: 500Optional

Maximum number of init times to return (default 96, ~4 days)

Default: 96

Responses

200

Successfully retrieved init times

application/json

422

Validation Error

application/json

get

/v1/power-forecast/init-times

HTTPcURLJavaScriptPython

GET /v1/power-forecast/init-times HTTP/1.1
Accept: */*

{
  "init_times": [
    {
      "init_time": "2025-12-01T18:00:00Z",
      "max_prediction_timedelta": 3720
    },
    {
      "init_time": "2025-12-01T12:00:00Z",
      "max_prediction_timedelta": 3720
    }
  ]
}