Skip to main content
POST
Submit portfolio forecast

Authorizations

Authorization
string
header
required

Body

application/json

Portfolio production and consumption forecasts for one delivery day.

delivery_day
string<date>
required

The day the energy is delivered, as a Europe/Berlin calendar day.

series
object[]
required

The day's series. Several series per control area and kind are allowed and summed. Omitted control areas count as zero.

Minimum array length: 1
unit
enum<string>
default:MW

MW: average power per quarter-hour. MWH: energy per quarter-hour.

Available options:
MW,
MWH
malo_mapping
object | null

MaLo-to-control-area mapping, required when a series is tagged by MaLo.

validate_only
boolean
default:false

Run the full validation and return the acknowledgment without storing the forecast. The input_hash matches the one a stored submission of the same payload gets.

Response

Forecast accepted

Acknowledgment of an accepted forecast submission.

delivery_day
string<date>
required
interval_count
integer
required

Quarter-hours in the delivery day: 96 on a normal day, 92 on the spring-forward day, 100 on the fall-back day.

series_received
integer
required
total_production_mwh
number
required

Total production energy received for the delivery day, in MWh.

total_consumption_mwh
number
required

Total consumption energy received for the delivery day, in MWh.

input_hash
string
required

Content hash of the submission. Identical payloads produce identical hashes.

status
enum<string>
default:received

received: the forecast is stored and picked up for processing. validated: the payload passed every check and nothing was stored, because validate_only was set.

Available options:
received,
validated