---
title: "Total Exempt Supply Volume (S0621)"
method: GET
path: "/saa/datasets/total-exempt-volume/{settlementDate}"
tags: ["SAA Datasets"]
---

# Total Exempt Supply Volume (S0621)

`GET /saa/datasets/total-exempt-volume/{settlementDate}`

Returns the total Import and Export Exempt Metered Volume (in MWh) for the requested settlement date and settlement run type.
            
This endpoint will not return any data until S0621 data is first published at the beginning of March 2025.

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

## Path parameters

- `settlementDate` string, date, required

## Query parameters

- `settlementRunType` string[]
- `format` 'json' | 'xml' | 'csv'

## Response `200`

Data retrieved

- InsightsApiModelsResponsesResponseWithMetadata1InsightsApiModelsResponsesTotalExemptSupplyVolumeTotalExemptSupplyVolumeResponse
  - `data` InsightsApiModelsResponsesTotalExemptSupplyVolumeTotalExemptSupplyVolumeResponse[], nullable
    - `creationTime` string, date-time
    - `settlementDate` string, date
    - `settlementPeriod` integer
    - `settlementRunType` string, nullable
    - `totalExemptSupplyVolume` 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/versions/d94e9edb295e/schema)
