---
title: "2-14 days ahead National Demand and surplus forecast (NDFD)"
method: GET
path: "/datasets/NDFD"
tags: ["BMRS Datasets"]
---

# 2-14 days ahead National Demand and surplus forecast (NDFD)

`GET /datasets/NDFD`

This endpoint provides the National Demand forecast received from NGESO.
Data is available daily and will show values for the 2 to 14 days ahead.
Expressed as an average MW value for each Settlement period. 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.

This API endpoint provides a maximum data output range of 92 days.

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

## Query parameters

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

## Response `200`

Data retrieved

- InsightsApiModelsResponsesDatasetResponse1InsightsApiModelsResponsesDemandForecastDatasetRowsDemandForecastNationalDaily
  - `data` InsightsApiModelsResponsesDemandForecastDatasetRowsDemandForecastNationalDaily[], nullable
    - `dataset` string, nullable
    - `publishTime` string, date-time
    - `forecastDate` string, date
    - `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)