ELelexon
BMRS Datasets

Actual Generation Output Per Generation Unit (B1610) stream

Changed on

This endpoint provides the actual metered volume output (MWh) per Settlement Period for all BM units (Positive, Negative or zero MWh values).

The information is published five days after the end of the operational period based on the Interim Information (II) Settlement Run and the data is refreshed by subsequent Settlement Runs.

The generation output returned by this endpoint is the metered volume and not the instantaneous power output as often appears in other specifications.

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

get/datasets/B1610/stream

Request

  • Base URL
    https://data.elexon.co.uk/bmrs/api/v1
  • Auth
    none declared

Query parameters

fromstring date-time required
Example:2022-08-12T00:00Z

The "from" start time or settlement date for the filter.

tostring date-time required
Example:2022-08-14T00:00Z

The "to" start time or settlement date for the filter.

settlementPeriodFrominteger

The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.

settlementPeriodTointeger

The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.

settlementRunTypestring
Example:DF

The settlement run type for the filter. If one is not specified, all run types will be displayed.

bmUnitstring[]

The BM units for the filter. Add each unit separately. If no BM unit is selected all BM units will be displayed.

[
  "T_CNQPS-1"
]

Response

Data retrieved

datasetstring nullable
psrTypestring nullable
bmUnitstring nullable
nationalGridBmUnitIdstring nullable
settlementDatestring date
settlementPeriodinteger
halfHourEndTimestring date-time
settlementRunTypestring nullable
quantitynumber double

Example response

[
  {
    "dataset": "B1610",
    "psrType": "Generation",
    "bmUnit": "T_CNQPS-1",
    "nationalGridBmUnitId": "CNQPS-1",
    "settlementDate": "2022-08-12",
    "settlementPeriod": 10,
    "halfHourEndTime": "2022-08-12T04:00:00Z",
    "settlementRunType": "DF",
    "quantity": 116.109
  }
]

Changes

  • d992cbaa9351Revision changes
    • info

      added the new optional query request parameter settlementRunType

    • info

      added the optional property / to the response with the status (media type: text/plain)

    • info

      added the optional property / to the response with the status (media type: application/json)

    • info

      added the optional property / to the response with the status (media type: text/json)