Sign in

v1

latestOpenAPI 3.0.42026-07-233182951.4 MB
Balancing Mechanism Physical

Market-wide physical data (PN, QPN, MILS, MELS)

This endpoint provides the physical data for multiple requested BMUs or all BMUs. It returns the data valid for a single settlement period.

Only one dataset can be queried at a time: PN, QPN, MILS, or MELS. The results from each dataset are transformed to a common response model, with fields not present in all 4 datasets dropped.

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

get/balancing/physical/all

Query parameters

dataset'PN' | 'QPN' | 'MILS' | 'MELS' required
Example:PN

Dataset to query.

settlementDatestring date required
Example:2023-01-18

The settlement date for the filter.

settlementPeriodinteger required
Example:3

The settlement period for the 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"
]
format'json' | 'xml' | 'csv'

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

Response

Data retrieved

Example response

{
  "data": [
    {
      "dataset": "PN",
      "settlementDate": "2022-07-01",
      "settlementPeriod": 3,
      "timeFrom": "2022-07-01T13:34:00Z",
      "timeTo": "2022-07-01T13:34:00Z",
      "levelFrom": 5,
      "levelTo": 46,
      "nationalGridBmUnit": "ABRBO-1",
      "bmUnit": "T_ABRBO-1"
    }
  ],
  "metadata": {
    "datasets": [
      "DATASET"
    ]
  }
}