Sign in

v1

latestOpenAPI 3.0.42026-07-233182951.4 MB
Balancing Mechanism Dynamic

Market-wide rate data (RDRE, RURE, RDRI, RURI)

This endpoint provides market-wide physical rate data, for all BMUs or a requested set of multiple BMUs. It returns the data valid for a given settlement period. This includes a snapshot of data valid at the start of the settlement period, and any changes published during that settlement period.

The settlement period to query can be specified as a date and settlement period. The settlement date must be provided in the format yyyy-MM-dd.

By default, all of the relevant datasets are returned: RDRE, RURE, RDRI, RURI.

This endpoint is quota limited. For individual rate 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/rates/all

Query parameters

settlementDatestring date required
Example:2022-09-01

The settlement date to filter.

settlementPeriodinteger required
Example:2

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 return. If omitted, all datasets will be returned.

[
  "RURE",
  "RDRE",
  "RDRI"
]
format'json' | 'xml' | 'csv'

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

Response

Data retrieved

Example response

{
  "data": [
    {
      "dataset": "RURE",
      "settlementDate": "2022-07-01",
      "settlementPeriod": 3,
      "time": "2022-07-01T13:34:00Z",
      "rate1": 0.4,
      "elbow2": 5,
      "rate2": 300.2,
      "nationalGridBmUnit": "ABRBO-1",
      "bmUnit": "T_ABRBO-1"
    }
  ],
  "metadata": {
    "datasets": [
      "DATASET"
    ]
  }
}