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

# Indicative volumes by settlement date (DISPTAV)

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

Returns the settlement indicative 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.

## Path parameters

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

## Query parameters

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

## Response `200`

Data retrieved

- InsightsApiModelsResponsesResponseWithMetadata1InsightsApiModelsResponsesBalancingSettlementIndicativeVolumeResponse
  - `data` InsightsApiModelsResponsesBalancingSettlementIndicativeVolumeResponse[], 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
    - `dataType` 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.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)