v1

latestOpenAPI 3.0.42026-07-233182951.4 MB

BMRS Datasets

Maximum Delivery Bid (MDB)

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.

get/datasets/MDB

Query parameters

settlementDatestring date required

Example:2026-06-25

The settlement date to query. This must be in the format yyyy-MM-dd.

settlementPeriodinteger required

Example:25

The settlement period to query. 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"
]

format'json' | 'xml' | 'csv'

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

Response

Data retrieved

Example response

{
  "data": [
    {
      "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"
    }
  ]
}