v1

latestOpenAPI 3.0.42026-07-233182951.4 MB

BMRS Datasets

Half-hourly generation outturn by fuel type (FUELHH) stream

This endpoint provides the half-hourly generation outturn (Generation By Fuel type) to give our users an indication of the generation outturn for Great Britain. The data is aggregated by Fuel Type category and updated at 30-minute intervals with average MW values over 30 minutes for each category.

This endpoint includes additional settlement parameters such as Settlement Date and Settlement Period. The Settlement Date fields cannot be set when a Publish Date field is set.

Settlement date parameters must be provided in the exact format yyyy-MM-dd.

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

get/datasets/FUELHH/stream

Query parameters

publishDateTimeFromstring date-time

Example:2022-06-25T00:00:00Z

publishDateTimeTostring date-time

Example:2022-06-26T00:00:00Z

settlementDateFromstring date

Example:2022-09-20

settlementDateTostring date

Example:2022-09-21

settlementPeriodinteger[]

List of Settlement Periods

[
  3,
  4
]

fuelTypestring[]

Fuel Type e.g. NUCLEAR

[
  "NUCLEAR"
]

Response

Data retrieved

datasetstring nullable

publishTimestring date-time nullable

startTimestring date-time nullable

settlementDatestring date nullable

settlementPeriodinteger nullable

fuelTypestring nullable

generationinteger nullable

Example response

[
  {
    "dataset": "FUELINST",
    "publishTime": "2022-06-25T13:00:00Z",
    "startTime": "2022-06-25T13:00:00Z",
    "settlementDate": "2022-06-25",
    "settlementPeriod": 3,
    "fuelType": "BIOMASS"
  }
]