---
title: "Day and day-ahead National Demand forecast (NDF)"
method: GET
path: "/datasets/NDF"
tags: ["BMRS Datasets"]
---

# Day and day-ahead National Demand forecast (NDF)

`GET /datasets/NDF`

This endpoint provides the National Demand forecast received from NGESO. Data is available
daily and will show values for the day 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 transformers and pumped storage units.
            
This API endpoint provides a maximum data output range of 1 day.
            
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

- InsightsApiModelsResponsesDatasetResponse1InsightsApiModelsResponsesDemandForecastDatasetRowsDemandForecastNationalDayAhead
  - `data` InsightsApiModelsResponsesDemandForecastDatasetRowsDemandForecastNationalDayAhead[], nullable
    - `dataset` string, nullable
    - `demand` integer, nullable
    - `publishTime` string, date-time
    - `startTime` string, date-time
    - `settlementDate` string, date
    - `settlementPeriod` integer
    - `boundary` 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.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)