---
title: "Year-Ahead Total Load Forecast Per Bidding Zone (YATL / B0650)"
method: GET
path: "/datasets/YATL"
tags: ["BMRS Datasets"]
---

# Year-Ahead Total Load Forecast Per Bidding Zone (YATL / B0650)

`GET /datasets/YATL`

This endpoint provides year-ahead total load per bidding zone forecast data with minimum possible
and maximum available loads provided in MW values.

This API endpoint has a maximum range of 367 days.

## Query parameters

- `publishDateTimeFrom` string, date-time, required
- `publishDateTimeTo` string, date-time, required
- `format` 'json' | 'xml' | 'csv'

## Response `200`

Data retrieved

- InsightsApiModelsResponsesDatasetResponse1InsightsApiModelsResponsesTransparencyDatasetRowsYearAheadTotalLoadPerBiddingZoneDatasetRow
  - `data` InsightsApiModelsResponsesTransparencyDatasetRowsYearAheadTotalLoadPerBiddingZoneDatasetRow[], nullable
    - `dataset` string, nullable
    - `documentId` string, nullable
    - `documentRevisionNumber` integer
    - `publishTime` string, date-time
    - `forecastYear` integer
    - `forecastWeek` integer
    - `minimumPossible` number, double
    - `maximumAvailable` number, double

## Other responses

- `400` — Error with query parameters - see response for details
- `429` — Too many requests
- `500` — Server error - please try again later

---

[API](https://skmtc.net/elexon/apis/bmrs-insights.md) · [All operations](https://skmtc.net/elexon/apis/bmrs-insights/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elexon/bmrs-insights/versions/d94e9edb295e/schema)