v1

latestOpenAPI 3.0.42026-07-233182951.4 MB

Bid-Offer Acceptances

Market-wide bid-offer acceptances (BOALF)

This endpoint provides the bid-offer acceptance data (BOALF) for multiple requested BMUs or all BMUs. It returns the data valid for a single settlement period.

The settlement period must be specified as a date and settlement period. The date parameter must be provided in the exact format yyyy-MM-dd.

get/balancing/acceptances/all

Query parameters

settlementDatestring date required

Example:2023-01-24

The settlement date for the filter.

settlementPeriodinteger required

Example:39

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.

[
  "T_DINO-2",
  "HUMR-1"
]

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

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

Response

Data retrieved

Example response

{
  "data": [
    {
      "settlementDate": "2022-06-25",
      "settlementPeriodFrom": 29,
      "settlementPeriodTo": 32,
      "timeFrom": "2022-06-25T13:34:00Z",
      "timeTo": "2022-06-25T13:37:00Z",
      "levelFrom": 5,
      "levelTo": 46,
      "nationalGridBmUnit": "ABRBO-1",
      "bmUnit": "T_ABRBO-1",
      "acceptanceNumber": 1234567,
      "acceptanceTime": "2022-06-25T13:30:00Z",
      "deemedBoFlag": true,
      "storFlag": true
    }
  ],
  "metadata": {
    "datasets": [
      "DATASET"
    ]
  }
}