---
title: "Acceptance volumes by settlement date (BOAV)"
method: GET
path: "/balancing/settlement/acceptance/volumes/all/{bidOffer}/{settlementDate}"
tags: ["Indicative Imbalance Settlement"]
---

# Acceptance volumes by settlement date (BOAV)

`GET /balancing/settlement/acceptance/volumes/all/{bidOffer}/{settlementDate}`

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.

## Path parameters

- `settlementDate` string, date, required
- `bidOffer` 'bid' | 'offer', required

## Query parameters

- `bmUnit` string[]
- `format` 'json' | 'xml'

## Response `200`

Data retrieved

- InsightsApiModelsResponsesResponseWithMetadata1InsightsApiModelsResponsesBalancingSettlementAcceptanceVolumeResponse
  - `data` InsightsApiModelsResponsesBalancingSettlementAcceptanceVolumeResponse[], nullable
    - `createdDateTime` string, date-time
    - `settlementDate` string, date
    - `settlementPeriod` integer
    - `startTime` string, date-time
    - `bmUnit` string, nullable
    - `bmUnitType` string
    - `leadPartyName` string, nullable
    - `nationalGridBmUnit` string, nullable
    - `acceptanceId` integer
    - `acceptanceDuration` string, nullable
    - `totalVolumeAccepted` number, double, nullable
    - `pairVolumes` InsightsApiModelsResponsesBalancingSettlementDerivedDataBidOfferPairs
      - `negative1` number, double, nullable
      - `positive1` number, double, nullable
      - `negative2` number, double, nullable
      - `positive2` number, double, nullable
      - `negative3` number, double, nullable
      - `positive3` number, double, nullable
      - `negative4` number, double, nullable
      - `positive4` number, double, nullable
      - `negative5` number, double, nullable
      - `positive5` number, double, nullable
      - `negative6` number, double, nullable
      - `positive6` number, double, nullable
  - `metadata` InsightsApiModelsMetadataApiResponseSourceMetadata
    - `datasets` string[], nullable

## Other responses

- `400` — Error with query parameters - see response for details
- `403` — Quota exceeded - see response for how long to wait before trying again
- `429` — Too many requests
- `500` — Server error - please try again later

---

[API](https://skmtc.net/elexon/apis/bmrs-insights.md) · [All operations](https://skmtc.net/elexon/apis/bmrs-insights/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elexon/bmrs-insights/revisions/d94e9edb295e/schema)