Sign in

v1

latestOpenAPI 3.0.42026-07-233182951.4 MB
BMRS Datasets

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

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 is subject to a limit of 100 requests per minute. Any requests made beyond this limit may result in a 429 error ("Too Many Requests")

get/datasets/UOU2T3YW

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"
]
format'json' | 'xml' | 'csv'

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

Response

Data retrieved

Example response

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