It is defined as equal to the year-ahead forecasted sum of power generated by plants on both TSO/DSO networks, from which is deduced:
the balance (export-import) of exchanges on interconnections between neighbouring bidding zones
the power absorbed by energy storage resources
Usage
load_year_ahead_total_forecast(
eic = NULL,
period_start = ymd(Sys.Date() - days(x = 1L), tz = "CET"),
period_end = ymd(Sys.Date(), tz = "CET"),
tidy_output = TRUE,
security_token = Sys.getenv("ENTSOE_PAT")
)Arguments
- eic
Energy Identification Code of the bidding zone/ country/control area
- period_start
POSIXct or YYYY-MM-DD HH:MM:SS format One year range limit applies
- period_end
POSIXct or YYYY-MM-DD HH:MM:SS format One year range limit applies
- tidy_output
Defaults to TRUE. If TRUE, then flatten nested tables.
- security_token
Security token for ENTSO-E transparency platform
Value
A tibble::tibble() with the queried data.
Examples
df <- entsoeapi::load_year_ahead_total_forecast(
eic = "10Y1001A1001A82H",
period_start = lubridate::ymd(x = "2022-01-01", tz = "CET"),
period_end = lubridate::ymd(x = "2022-12-31", tz = "CET"),
tidy_output = TRUE
)
#>
#> ── API call ────────────────────────────────────────────────────────────────────────────────────────────────────────────
#> → https://web-api.tp.entsoe.eu/api?documentType=A65&processType=A33&outBiddingZone_Domain=10Y1001A1001A82H&periodStart=202112312300&periodEnd=202212302300&securityToken=<...>
#> <- HTTP/2 200
#> <- date: Mon, 13 Apr 2026 08:52:01 GMT
#> <- content-type: text/xml
#> <- content-disposition: inline; filename="Total Load Forecast 202112312300-202212302300.xml"
#> <- x-content-type-options: nosniff
#> <- x-xss-protection: 0
#> <- vary: accept-encoding
#> <- content-encoding: gzip
#> <- strict-transport-security: max-age=15724800; includeSubDomains
#> <-
#> ✔ response has arrived
#> ✔ Additional type names have been added!
#> ✔ Additional eic names have been added!
#> ✔ Additional definitions have been added!
dplyr::glimpse(df)
#> Rows: 106
#> Columns: 21
#> $ ts_out_bidding_zone_domain_mrid <chr> "10Y1001A1001A82H", "10Y1001A1001A82H", "10Y1001A1001A82H", "10Y1001A1001A82H"…
#> $ ts_out_bidding_zone_domain_name <chr> "Germany_Luxemburg", "Germany_Luxemburg", "Germany_Luxemburg", "Germany_Luxemb…
#> $ type <chr> "A65", "A65", "A65", "A65", "A65", "A65", "A65", "A65", "A65", "A65", "A65", "…
#> $ type_def <chr> "System total load", "System total load", "System total load", "System total l…
#> $ process_type <chr> "A33", "A33", "A33", "A33", "A33", "A33", "A33", "A33", "A33", "A33", "A33", "…
#> $ process_type_def <chr> "Year ahead", "Year ahead", "Year ahead", "Year ahead", "Year ahead", "Year ah…
#> $ ts_object_aggregation <chr> "A01", "A01", "A01", "A01", "A01", "A01", "A01", "A01", "A01", "A01", "A01", "…
#> $ ts_object_aggregation_def <chr> "Area", "Area", "Area", "Area", "Area", "Area", "Area", "Area", "Area", "Area"…
#> $ ts_business_type <chr> "A60", "A60", "A60", "A60", "A60", "A60", "A60", "A60", "A60", "A60", "A60", "…
#> $ ts_business_type_def <chr> "Minimum possible", "Minimum possible", "Minimum possible", "Minimum possible"…
#> $ created_date_time <dttm> 2026-04-13 08:52:01, 2026-04-13 08:52:01, 2026-04-13 08:52:01, 2026-04-13 08:…
#> $ revision_number <dbl> 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, …
#> $ time_period_time_interval_start <dttm> 2021-12-26 23:00:00, 2021-12-26 23:00:00, 2021-12-26 23:00:00, 2021-12-26 23:…
#> $ time_period_time_interval_end <dttm> 2023-01-01 23:00:00, 2023-01-01 23:00:00, 2023-01-01 23:00:00, 2023-01-01 23:…
#> $ ts_resolution <chr> "P7D", "P7D", "P7D", "P7D", "P7D", "P7D", "P7D", "P7D", "P7D", "P7D", "P7D", "…
#> $ ts_time_interval_start <dttm> 2021-12-26 23:00:00, 2021-12-26 23:00:00, 2021-12-26 23:00:00, 2021-12-26 23:…
#> $ ts_time_interval_end <dttm> 2023-01-01 23:00:00, 2023-01-01 23:00:00, 2023-01-01 23:00:00, 2023-01-01 23:…
#> $ ts_mrid <dbl> 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, …
#> $ ts_point_dt_start <dttm> 2021-12-26 23:00:00, 2022-01-02 23:00:00, 2022-01-09 23:00:00, 2022-01-16 23:…
#> $ ts_point_quantity <dbl> 35402.56, 42031.18, 45159.67, 44878.62, 45039.74, 44693.06, 45282.67, 43683.53…
#> $ ts_quantity_measure_unit_name <chr> "MAW", "MAW", "MAW", "MAW", "MAW", "MAW", "MAW", "MAW", "MAW", "MAW", "MAW", "…