---
title: "Demand and Surplus Forecast Data (2-156 weeks ahead) Surplus"
method: GET
path: "/gb/elexon/forecasts/ocnmf3y"
tags: ["Elexon"]
---

# Demand and Surplus Forecast Data (2-156 weeks ahead) Surplus

`GET /gb/elexon/forecasts/ocnmf3y`

The Demand and Surplus forecast surplus data is received hourly from NGESO. It shows the daily peak half hour MW value of Generating Plant Demand Margin for each week for the 2 to 156 weeks ahead.

## Query parameters

- `publish_date_from` string, date-time, required
- `publish_date_to` string, date-time, required
- `limit` integer
- `offset` integer
- `timezone` 'UTC' | 'Europe/Berlin' | 'Europe/London' | 'America/New_York' | 'America/Chicago' | 'America/Los_Angeles'

## Response `200`

Success

- object
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` ElexonOCNMF3Y[], required
    - `dataset` string
    - `publishTime` string, date-time
    - `week` integer
    - `year` integer
    - `surplus` integer

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `429` — Too Many Requests

---

[API](https://skmtc.net/modoenergy/apis/modo-energy-api.md) · [All operations](https://skmtc.net/modoenergy/apis/modo-energy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/modoenergy/modo-energy-api/revisions/6c4b83d3fc12/schema)