Sign in

v1

latestOpenAPI 3.0.42026-07-233182951.4 MB
Balancing Mechanism Dynamic

Market-wide dynamic parameters data (MDO, MDB)

This endpoint provides the Maximum Delivery Bid (MDB) and Maximum Delivery Offer (MDO) for all BMUs or a requested set of multiple BMUs. It returns the data valid for a given settlement period. This includes data valid at the start of the 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.

get/balancing/dynamic/dynamicParameters/all

Query parameters

settlementDatestring date required
Example:2026-06-25

The settlement date to filter.

settlementPeriodinteger required
Example:29

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.

[
  "AG-HLIM04"
]
datasetstring[]

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

[
  "MDO",
  "MDB"
]
format'json' | 'xml' | 'csv'

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

Response

Data retrieved

Example response

{
  "data": [
    {
      "dataset": "MDO",
      "settlementDate": "2026-06-25",
      "settlementPeriod": 29,
      "timeFrom": "2026-06-25T13:00:00Z",
      "timeTo": "2026-06-25T13:30:00Z",
      "levelFrom": 16,
      "levelTo": 18,
      "nationalGridBmUnit": "AG-HLIM04",
      "bmUnit": "2__HANGE004",
      "publishTime": "2026-06-25T12:59:00Z",
      "serialNumber": "01832"
    }
  ],
  "metadata": {
    "datasets": [
      "DATASET"
    ]
  }
}