---
title: "Month-Ahead Total Load Forecast Per Bidding Zone (MATL / B0640) stream"
method: GET
path: "/datasets/MATL/stream"
tags: ["BMRS Datasets"]
---

# Month-Ahead Total Load Forecast Per Bidding Zone (MATL / B0640) stream

`GET /datasets/MATL/stream`

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

This endpoint has an optimised JSON payload and is aimed at frequent requests for the data.

## Query parameters

- `publishDateTimeFrom` string, date-time, required
- `publishDateTimeTo` string, date-time, required

## Response `200`

Data retrieved

- InsightsApiModelsResponsesTransparencyDatasetRowsMonthAheadTotalLoadPerBiddingZoneDatasetRow[]
  - `dataset` string, nullable
  - `documentId` string, nullable
  - `documentRevisionNumber` integer
  - `publishTime` string, date-time
  - `forecastWeekCommencingDate` string, date
  - `forecastYear` integer
  - `forecastMonth` string, nullable
  - `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)