---
title: "History of the one-year demand forecast (NDFW, TSDFW)"
method: GET
path: "/forecast/demand/weekly/history"
tags: ["Demand Forecast"]
---

# History of the one-year demand forecast (NDFW, TSDFW)

`GET /forecast/demand/weekly/history`

## Request

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

Retrieve historical weekly forecast demand data

## Query parameters

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

## Response `200`

Data retrieved

- InsightsApiModelsResponsesResponseWithMetadata1InsightsApiModelsResponsesDemandForecastDemandForecastWeekly
  - `data` InsightsApiModelsResponsesDemandForecastDemandForecastWeekly[], nullable
    - `publishTime` string, date-time, nullable
    - `transmissionSystemDemand` integer
    - `nationalDemand` integer, nullable
    - `forecastWeek` integer
    - `forecastYear` integer
    - `weekStartDate` string, date
  - `metadata` InsightsApiModelsMetadataApiResponseSourceMetadata
    - `datasets` 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.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)