Elexon

Elexon SAA Datasets API

Datasets received from the Settlement Administration Agent (SAA)

Documentation GitHub OpenAPI

Operations 1

GET /saa/datasets/total-exempt-volume/{settlementDate} Total Exempt Supply Volume (S0621) #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/elexon:elexon-saa-datasets-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Insights.Api SAA Datasets API
  version: '1.0'
  description: Datasets received from the Settlement Administration Agent (SAA)
servers:
- url: https://data.elexon.co.uk/bmrs/api/v1
tags:
- name: SAA Datasets
  description: Datasets received from the Settlement Administration Agent (SAA)
paths:
  /saa/datasets/total-exempt-volume/{settlementDate}:
    get:
      tags:
      - SAA Datasets
      summary: Total Exempt Supply Volume (S0621)
      description: '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.'
      parameters:
      - name: settlementDate
        in: path
        description: The settlement date for the filter.
        required: true
        schema:
          type: string
          format: date
          example: '2025-02-27'
        example: '2025-02-27'
      - name: settlementRunType
        in: query
        description: 'The settlement run type for the filter.

          If one or more run types are specified, only data with those run types is returned.

          If no run type is specified, for each settlement period only the single data point with the most recent run type is returned.'
        schema:
          type: array
          items:
            type: string
          example:
          - II
          - SF
        example:
        - II
        - SF
      - name: format
        in: query
        description: Response data format. Use json/xml to include metadata.
        schema:
          enum:
          - json
          - xml
          - csv
          type: string
      responses:
        '200':
          description: Data retrieved
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/Insights.Api.Models.Responses.ResponseWithMetadata-1_Insights.Api.Models.Responses.TotalExemptSupplyVolume.TotalExemptSupplyVolumeResponse'
            application/json:
              schema:
                $ref: '#/components/schemas/Insights.Api.Models.Responses.ResponseWithMetadata-1_Insights.Api.Models.Responses.TotalExemptSupplyVolume.TotalExemptSupplyVolumeResponse'
            text/json:
              schema:
                $ref: '#/components/schemas/Insights.Api.Models.Responses.ResponseWithMetadata-1_Insights.Api.Models.Responses.TotalExemptSupplyVolume.TotalExemptSupplyVolumeResponse'
            application/xml:
              schema:
                $ref: '#/components/schemas/Insights.Api.Models.Responses.ResponseWithMetadata-1_Insights.Api.Models.Responses.TotalExemptSupplyVolume.TotalExemptSupplyVolumeResponse'
            text/xml:
              schema:
                $ref: '#/components/schemas/Insights.Api.Models.Responses.ResponseWithMetadata-1_Insights.Api.Models.Responses.TotalExemptSupplyVolume.TotalExemptSupplyVolumeResponse'
            text/csv:
              schema:
                $ref: '#/components/schemas/Insights.Api.Models.Responses.ResponseWithMetadata-1_Insights.Api.Models.Responses.TotalExemptSupplyVolume.TotalExemptSupplyVolumeResponse'
        '429':
          description: Too many requests
        '400':
          description: Error with query parameters - see response for details
        '500':
          description: Server error - please try again later
      operationId: getSaaDatasetsTotalExemptVolumeBySettlementDate
      x-operation-id-source: derived
components:
  schemas:
    Insights.Api.Models.Responses.TotalExemptSupplyVolume.TotalExemptSupplyVolumeResponse:
      type: object
      properties:
        creationTime:
          type: string
          format: date-time
          example: '2025-01-16T15:31:12Z'
        settlementDate:
          type: string
          format: date
          example: '2025-01-16'
        settlementPeriod:
          type: integer
          format: int32
          example: 5
        settlementRunType:
          type:
          - string
          - 'null'
          example: R1
        totalExemptSupplyVolume:
          type:
          - number
          - 'null'
          format: double
          example: 505.3
      additionalProperties: false
    ? Insights.Api.Models.Responses.ResponseWithMetadata-1_Insights.Api.Models.Responses.TotalExemptSupplyVolume.TotalExemptSupplyVolumeResponse
    : type: object
      properties:
        data:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/Insights.Api.Models.Responses.TotalExemptSupplyVolume.TotalExemptSupplyVolumeResponse'
        metadata:
          $ref: '#/components/schemas/Insights.Api.Models.Metadata.ApiResponseSourceMetadata'
      additionalProperties: false
    Insights.Api.Models.Metadata.ApiResponseSourceMetadata:
      type: object
      properties:
        datasets:
          type:
          - array
          - 'null'
          items:
            type: string
          example:
          - DATASET
      additionalProperties: false
x-provenance:
  method: harvested
  publisher: Elexon
  source: https://data.elexon.co.uk/swagger/v1/swagger.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)