---
title: "2-14 days ahead demand surplus forecast (OCNMFD) stream"
method: GET
path: "/datasets/OCNMFD/stream"
tags: ["BMRS Datasets"]
---

# 2-14 days ahead demand surplus forecast (OCNMFD) stream

`GET /datasets/OCNMFD/stream`

The demand surplus forecast data is received hourly from NGESO.
It shows the daily peak half hour MW value of generating plant demand surplus for each day for the 2 to 14 days ahead.

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

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