v1

latestOpenAPI 3.0.42026-07-233182951.4 MB

BMRS Datasets

2 to 156 weeks ahead generation availability aggregated by Balancing Mechanism Units (UOU2T3YW) stream

This endpoint forward view of availability (also referred to as Output Usable data under the Grid Code) for generation and interconnector capacity, accounting for planned outages covering availability data from 2 weeks ahead to 156 weeks ahead; it is aggregated by Balancing Mechanism Units (BMUs).

In the context of this report, BMUs can be considered as generating units. Elexon BMUs differs from NGC BMUs by including a prefix e.g. 'T_'. The mapping between NGC and Elexon BMUs can be retrieved via reference data API endpoints.

This endpoint has an optimised JSON payload and is aimed at frequent requests for the data.

get/datasets/UOU2T3YW/stream

Query parameters

fuelTypestring[]

The fuel type to query. Add each fuel type separately. If no fuel types are supplied, all fuel types will be returned.

[
  "CCGT"
]

publishDateTimeFromstring date-time

Start of the Publish Time range to query. If specified, PublishDateTimeTo must also be specified. If both are omitted, latest published data is returned.

publishDateTimeTostring date-time

End of the Publish Time range to query. If specified, PublishDateTimeFrom must also be specified. If both are omitted, latest published data is returned.

bmUnitstring[]

The BM units to query. Add each unit separately. Either the Elexon ID or the National Grid ID can be used. If no BM unit is supplied all BM units will be returned.

[
  "T_CARR-1"
]

Response

Data retrieved

datasetstring nullable

fuelTypestring nullable

nationalGridBmUnitstring nullable

bmUnitstring nullable

publishTimestring date-time nullable

weekinteger nullable

yearinteger nullable

outputUsableinteger nullable

Example response

[
  {
    "fuelType": "CCGT",
    "nationalGridBmUnit": "CARR-1",
    "bmUnit": "T_CARR-1",
    "publishTime": "2022-08-10T15:00:00Z",
    "week": 34,
    "year": 2022,
    "outputUsable": 442
  }
]