v1

latestOpenAPI 3.0.42026-07-233182951.4 MB

BMRS Datasets

Maximum Delivery Bid (MDB) stream

This endpoint provides time-varying maximum import values that a battery unit or other Balancing Mechanism Unit can deliver if dispatched. This reflects dynamic energy availability rather than static power limits. Provided as a streaming endpoint.

get/datasets/MDB/stream

Query parameters

fromstring date-time required

Example:2026-06-25

The settlement date to query from.

tostring date-time required

Example:2026-06-25

The settlement date to query up to.

settlementPeriodFrominteger

Example:25

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

settlementPeriodTointeger

Example:26

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

bmUnitstring[]

The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.

[
  "AG-HLIM04"
]

Response

Data retrieved

datasetstring nullable

settlementDatestring date

settlementPeriodinteger

timeFromstring date-time

timeTostring date-time

levelFromnumber double

levelTonumber double

nationalGridBmUnitstring nullable

bmUnitstring nullable

publishTimestring date-time

serialNumberstring nullable

Example response

[
  {
    "dataset": "MDB",
    "settlementDate": "2026-06-25",
    "settlementPeriod": 25,
    "timeFrom": "2026-06-25T11:01:00Z",
    "timeTo": "2026-06-25T11:30:00Z",
    "levelFrom": -14,
    "levelTo": -14,
    "nationalGridBmUnit": "AG-HLIM04",
    "bmUnit": "2__HANGE004",
    "publishTime": "2026-06-25T10:58:00Z",
    "serialNumber": "00571"
  }
]