Sign in

v1

latestOpenAPI 3.0.42026-07-233182951.4 MB
Balancing Services Adjustment - Disaggregated

Disaggregated balancing services adjustment time series (DISBSAD)

This endpoint provides disaggregated balancing services adjustment data batched by settlement period. Each batch in the time series contains a summary of all records for that settlement period, detailing the number of buy and sell actions, price information and volume information.

By default, the from and to parameters filter the data by start time inclusively. If the settlementPeriodFrom or settlementPeriodTo parameters are provided, the corresponding from or to parameter instead filters on settlement date, allowing for searching by a combination of start time and/or settlement date & settlement period. Note: When filtering via settlement date, from/to are treated as Dates only, with the time being ignored. For example, 2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.

All Dates and DateTimes should be expressed as defined within <a href="https://datatracker.ietf.org/doc/html/rfc3339#section-5.6" target="_blank">RFC 3339</a>.

Some examples of date parameter combinations are shown below.

Filtering from start time to start time:

/balancing/nonbm/disbsad/summary?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z

Filtering from start time to settlement date and period:

/balancing/nonbm/disbsad/summary?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodTo=1

Filtering from settlement date and period to start time:

/balancing/nonbm/disbsad/summary?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1

Filtering from settlement date and period to settlement date and period:

/balancing/nonbm/disbsad/summary?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1
get/balancing/nonbm/disbsad/summary

Query parameters

fromstring date-time required
Example:2022-09-20T00:00Z

The "from" start time or settlement date for the filter.

tostring date-time required
Example:2022-09-27T00:00Z

The "to" start time or settlement date for the filter.

settlementPeriodFrominteger

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

settlementPeriodTointeger

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

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

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

Response

Data retrieved

Example response

{
  "data": [
    {
      "settlementDate": "2022-09-26",
      "settlementPeriod": 27,
      "startTime": "2022-09-26T13:00:00Z",
      "buyActionCount": 2,
      "sellActionCount": 2,
      "buyPriceMinimum": 10.23,
      "buyPriceMaximum": 30.45,
      "buyPriceAverage": 20.34,
      "sellPriceMinimum": 1.23,
      "sellPriceMaximum": 3.45,
      "sellPriceAverage": 2.34,
      "buyVolumeTotal": 40.68,
      "sellVolumeTotal": 4.68,
      "netVolume": 36
    }
  ],
  "metadata": {
    "datasets": [
      "DATASET"
    ]
  }
}