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

# Acceptance volumes by settlement period (BOAV)

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

## Request

- Base URL: `https://data.elexon.co.uk/bmrs/api/v1`
- URL: `https://data.elexon.co.uk/bmrs/api/v1/balancing/settlement/acceptance/volumes/all/{bidOffer}/{settlementDate}/{settlementPeriod}`
- Auth: none declared

Returns the settlement acceptance volumes for the requested settlement period.

Only messages generated for the latest settlement run are returned.
            
Settlement date parameter must be provided in the exact format yyyy-MM-dd.

## Path parameters

- `settlementPeriod` integer, required
- `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
- `429`: Too many requests
- `500`: Server error - please try again later

---

[API](https://skmtc.dev/elexon/apis/bmrs-insights.md) - [All operations](https://skmtc.dev/elexon/apis/bmrs-insights/llms.txt) - [OpenAPI document](https://skmtc.dev/elexon/apis/bmrs-insights/revisions/d992cbaa9351?raw)