Sign in

v1

latestOpenAPI 3.0.42026-07-233182951.4 MB
Balancing Mechanism Dynamic

Market-wide dynamic data (SEL, SIL, MZT, MNZT, MDV, MDP, NTB, NTO, NDZ)

This endpoint provides the dynamic data for multiple requested BMUs or all BMUs, excluding dynamic rate data. It returns the data valid for a single settlement period. This includes a snapshot of data valid at the start of the settlement period, and any changes published during that settlement period.

By default, all of the relevant datasets are returned: SIL, SEL, NDZ, NTB, NTO, MZT, MNZT, MDV & MDP. The results from each dataset are transformed to a common response model, with the common integer field Value mapped from the fields Level, Period, Volume or Notice in the original dataset, as relevant.

The settlement period must be specified as a date and settlement period. The date parameter must be provided in the exact format yyyy-MM-dd.

This endpoint is quota limited. For individual dynamic datasets, use the relevant /datasets/ endpoints. For real-time updates as each data point is published, use the Insights IRIS service. You can register for free at https://bmrs.elexon.co.uk/iris . For historical data, check out the IRIS archive, which keeps a record of all published datasets.

get/balancing/dynamic/all

Query parameters

settlementDatestring date required
Example:2023-01-18

The settlement date or datetime to filter.

settlementPeriodinteger required
Example:3

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

bmUnitstring[]

The BM Units to query. Elexon or NGC BMU IDs can be used. If omitted, results for all BM units will be returned.

[
  "2__HFLEX001",
  "HUMR-1"
]
datasetstring[]

Datasets to filter. If omitted, all datasets will be returned.

[
  "SEL",
  "MNZT",
  "MDP"
]
format'json' | 'xml' | 'csv'

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

Response

Data retrieved

Example response

{
  "data": [
    {
      "dataset": "SEL",
      "bmUnit": "T_ABRBO-1",
      "nationalGridBmUnit": "ABRBO-1",
      "time": "2022-07-01T13:34:00Z",
      "value": 5,
      "settlementDate": "2022-07-01",
      "settlementPeriod": 3
    }
  ],
  "metadata": {
    "datasets": [
      "DATASET"
    ]
  }
}