---
title: "Week-ahead total load forecast (WATL/B0630)"
method: GET
path: "/forecast/demand/total/week-ahead"
tags: ["Demand Forecast"]
---

# Week-ahead total load forecast (WATL/B0630)

`GET /forecast/demand/total/week-ahead`

## Request

- Base URL: `https://data.elexon.co.uk/bmrs/api/v1`
- URL: `https://data.elexon.co.uk/bmrs/api/v1/forecast/demand/total/week-ahead`
- Auth: none declared

This endpoint returns week-ahead total load forecast per bidding zone data with the minimum possible
and maximum available total loads in MW values, filtered by forecast week.
            
For a given forecast date, if more than one forecast has been published, only the most recent forecast
is returned.
            
This API endpoint has a maximum range of 367 days.
            
Date parameters must be provided in the exact format yyyy-MM-dd.

## Query parameters

- `from` string, date, required
- `to` string, date, required
- `format` 'json' | 'xml' | 'csv'

## Response `200`

Data retrieved

- InsightsApiModelsResponsesResponseWithMetadata1InsightsApiModelsResponsesTransparencyWeekAheadTotalLoadPerBiddingZone
  - `data` InsightsApiModelsResponsesTransparencyWeekAheadTotalLoadPerBiddingZone[], nullable
    - `publishTime` string, date-time
    - `forecastDate` string, date
    - `forecastWeek` integer
    - `minimumPossible` number, double
    - `maximumAvailable` number, double
  - `metadata` InsightsApiModelsMetadataApiResponseSourceMetadata
    - `datasets` string[], nullable

## 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.dev/elexon/apis/bmrs-insights.md) - [All operations](https://skmtc.dev/elexon/apis/bmrs-insights/llms.txt) - [OpenAPI document](https://skmtc.dev/elexon/apis/bmrs-insights/revisions/d992cbaa9351?raw)