v1

latestOpenAPI 3.0.42026-07-233182951.4 MB

Indicative Imbalance Settlement

Acceptance volumes by settlement date (BOAV)

Returns the settlement acceptance volumes for the requested settlement date.

For each settlement period within the range, only messages generated for the latest settlement run are returned.

Settlement date parameter must be provided in the exact format yyyy-MM-dd.

This endpoint is quota limited. For real-time updates as each data point is published, use the Insights IRIS service. You can register for free at https://bmrs.elexon.co.uk/iris . For historical data, check out the IRIS archive, which keeps a record of all published datasets.

get/balancing/settlement/acceptance/volumes/all/{bidOffer}/{settlementDate}

Path parameters

settlementDatestring date required

Example:2024-02-01

This must be in the format yyyy-MM-dd.

bidOffer'bid' | 'offer' required

Example:bid

Query parameters

bmUnitstring[]

Elexon or NGC BMU IDs can be used. If omitted, results for all BM units will be returned.

[
  "DALSW-1"
]

format'json' | 'xml'

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

Response

Data retrieved

Example response

{
  "data": [
    {
      "createdDateTime": "2023-02-28T15:31:12Z",
      "settlementDate": "2023-03-01",
      "settlementPeriod": 2,
      "startTime": "2023-03-01T00:30:00Z",
      "bmUnit": "T_ABRBO-1",
      "bmUnitType": "T",
      "leadPartyName": "Aberdeen Offshore Wind Farm",
      "nationalGridBmUnit": "ABRBO-1",
      "acceptanceId": 76110,
      "acceptanceDuration": "L",
      "totalVolumeAccepted": -75.725,
      "pairVolumes": {
        "positive1": 23062.377,
        "positive2": 5017.6255
      }
    }
  ],
  "metadata": {
    "datasets": [
      "DATASET"
    ]
  }
}