Sign in

v1

latestOpenAPI 3.0.42026-07-233182951.4 MB
Generation Forecast

Evolution of the three-year generation capacity forecast over time (FOU2T3YW)

This endpoint provides all weekly generation forecasts over time for a given Year and Week

get/forecast/availability/weekly/evolution

Query parameters

yearinteger required
Example:2024

The forecast year for the filter.

weekinteger required
Example:17

The forecast week for the filter.

level'total' | 'fuelType' | 'bmUnit'
Example:fuelType

The filter level for the forecast. This can be one of the following:

  • total: the total forecast for the given time period.
  • bmUnit: the forecast for each specified BM unit.
  • fuelType: the forecast aggregated, and optionally filtered by fuel type.
bmUnitstring[]

The BM units to query. Add each unit separately. Either the Elexon ID (Eg: T_CARR-1) or National Grid ID (Eg: CARR-1) can be used. Between 1 and 10 units should be queried when using the bmUnit level.

fuelTypestring[]

The fuel type to query when using the fuelType level. Add each fuel type separately. If no fuel types are supplied, all fuel types will be returned.

[
  "CCGT"
]
format'json' | 'xml' | 'csv'

Response data format. Use json/xml to include metadata.

Response

OK

Example response

{
  "data": [
    {
      "publishTime": "2024-06-07T15:00:00Z",
      "fuelType": "CCGT",
      "ngcBmUnit": "CARR-1",
      "bmUnit": "T_CARR-1",
      "outputUsable": 418,
      "year": 2024,
      "calendarWeekNumber": 23
    }
  ],
  "metadata": {
    "datasets": [
      "DATASET"
    ]
  }
}