---
title: "Historical daily surplus forecast (OCNMFD)"
method: GET
path: "/forecast/surplus/daily/history"
tags: ["Surplus Forecast"]
---

# Historical daily surplus forecast (OCNMFD)

`GET /forecast/surplus/daily/history`

## Request

- Base URL: `https://data.elexon.co.uk/bmrs/api/v1`
- URL: `https://data.elexon.co.uk/bmrs/api/v1/forecast/surplus/daily/history`
- Auth: none declared

This endpoint provides the historic Generating Plant Operating Surplus covering 2 days ahead to 14 days ahead in MW values.
The historic API outputs the latest published data for historic daily surplus forecast for D+2 to D+14

## Query parameters

- `publishTime` string, date-time, required
- `format` 'json' | 'xml' | 'csv'

## Response `200`

OK

- InsightsApiModelsResponsesResponseWithMetadata1InsightsApiModelsResponsesForecastSurplusForecastSurplusDaily
  - `data` InsightsApiModelsResponsesForecastSurplusForecastSurplusDaily[], nullable
    - `publishTime` string, date-time
    - `surplus` integer, nullable
    - `forecastDate` string, date
  - `metadata` InsightsApiModelsMetadataApiResponseSourceMetadata
    - `datasets` string[], nullable

---

[API](https://skmtc.dev/elexon/apis/bmrs-insights.md) - [All operations](https://skmtc.dev/elexon/apis/bmrs-insights/llms.txt) - [OpenAPI document](https://skmtc.dev/elexon/apis/bmrs-insights/revisions/d992cbaa9351?raw)