---
title: "2-52 weeks ahead National Demand and surplus forecast (NDFW) stream"
method: GET
path: "/datasets/NDFW/stream"
tags: ["BMRS Datasets"]
---

# 2-52 weeks ahead National Demand and surplus forecast (NDFW) stream

`GET /datasets/NDFW/stream`

This endpoint provides the National Demand forecast received from NGESO.
Data is available from 4pm each Thursday and will show values for the 2 to 52 weeks ahead.
Expressed as an average MW value for each week. The forecast is based on historically metered generation output for Great Britain.
This value INCLUDES transmission losses, but EXCLUDES interconnector flows and demand from station.

Specific publish time filters may be supplied, otherwise this will retrieve the latest published forecast.

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

## Query parameters

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

## Response `200`

Data retrieved

- InsightsApiModelsResponsesDemandForecastDatasetRowsDemandForecastNationalWeekly[]
  - `dataset` string, nullable
  - `publishTime` string, date-time
  - `year` integer
  - `week` integer
  - `demand` integer, 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.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)