Elexon Load Shape API
Load shape period data and load shape totals data as calculated by the Load Shaping Service
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/elexon:elexon-load-shape-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.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Insights.Api Load Shape API
version: '1.0'
description: Load shape period data and load shape totals data as calculated by the Load Shaping Service
servers:
- url: https://data.elexon.co.uk/bmrs/api/v1
tags:
- name: Load Shape
description: Load shape period data and load shape totals data as calculated by the Load Shaping Service
paths:
/lss/load-shape-period:
get:
tags:
- Load Shape
summary: Load shape period data (IF022)
description: 'This endpoint enables the retrieval of load shape period (IF022) data for a specified date and settlement period range.
For more information on Load shape data & load shape categories please view the
LSS method statement.
Date parameter must be provided in the exact format yyyy-MM-dd.'
parameters:
- name: date
in: query
description: The settlement date to return load shape period data for. This must be in the format yyyy-MM-dd.
required: true
schema:
type: string
format: date
example: '2026-03-01'
example: '2026-03-01'
- name: settlementPeriodFrom
in: query
description: Optional settlement period range start (inclusive).
schema:
type: integer
format: int32
example: 1
example: 1
- name: settlementPeriodTo
in: query
description: Optional settlement period range end (inclusive).
schema:
type: integer
format: int32
example: 10
example: 10
- 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.Data.Entities.LoadShapePeriodData'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.ResponseWithMetadata-1_Insights.Api.Models.Data.Entities.LoadShapePeriodData'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.ResponseWithMetadata-1_Insights.Api.Models.Data.Entities.LoadShapePeriodData'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.ResponseWithMetadata-1_Insights.Api.Models.Data.Entities.LoadShapePeriodData'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.ResponseWithMetadata-1_Insights.Api.Models.Data.Entities.LoadShapePeriodData'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.ResponseWithMetadata-1_Insights.Api.Models.Data.Entities.LoadShapePeriodData'
'400':
description: Error with query parameters - see response for details
'429':
description: Too many requests
'500':
description: Server error - please try again later
operationId: getLssLoadShapePeriod
x-operation-id-source: derived
/lss/load-shape-period/stream:
get:
tags:
- Load Shape
summary: Load shape period data stream (IF022)
description: 'This endpoint provides a stream of load shape period (IF022) data for a specified date and settlement period range.
For more information on Load shape data & load shape categories please view the
LSS method statement.
Date parameters must be provided in the exact format yyyy-MM-dd.'
parameters:
- name: fromDate
in: query
description: The settlement date range start (inclusive). This must be in the format yyyy-MM-dd.
required: true
schema:
type: string
format: date
example: '2026-03-01'
example: '2026-03-01'
- name: toDate
in: query
description: The settlement date range end (inclusive). This must be in the format yyyy-MM-dd.
required: true
schema:
type: string
format: date
example: '2026-03-02'
example: '2026-03-02'
- name: settlementPeriodFrom
in: query
description: Optional settlement period range start (inclusive).
schema:
type: integer
format: int32
example: 40
example: 40
- name: settlementPeriodTo
in: query
description: Optional settlement period range end (inclusive).
schema:
type: integer
format: int32
example: 2
example: 2
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Data.Entities.LoadShapePeriodData'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Data.Entities.LoadShapePeriodData'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Data.Entities.LoadShapePeriodData'
'400':
description: Error with query parameters - see response for details
'429':
description: Too many requests
'500':
description: Server error - please try again later
operationId: getLssLoadShapePeriodStream
x-operation-id-source: derived
/lss/load-shape-totals:
get:
tags:
- Load Shape
summary: Load shape totals data (IF023)
description: 'This endpoint enables the retrieval of Load shape totals data (IF023) for a specified settlement day.
For more information on Load shape data & load shape categories please view the
LSS method statement.
Date parameter must be provided in the exact format yyyy-MM-dd.'
parameters:
- name: fromDate
in: query
description: The settlement date range start (inclusive). This must be in the format yyyy-MM-dd.
required: true
schema:
type: string
format: date
example: '2026-03-01'
example: '2026-03-01'
- name: toDate
in: query
description: The settlement date range end (inclusive). This must be in the format yyyy-MM-dd.
required: true
schema:
type: string
format: date
example: '2026-03-31'
example: '2026-03-31'
- 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.Data.Entities.LoadShapeTotalsData'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.ResponseWithMetadata-1_Insights.Api.Models.Data.Entities.LoadShapeTotalsData'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.ResponseWithMetadata-1_Insights.Api.Models.Data.Entities.LoadShapeTotalsData'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.ResponseWithMetadata-1_Insights.Api.Models.Data.Entities.LoadShapeTotalsData'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.ResponseWithMetadata-1_Insights.Api.Models.Data.Entities.LoadShapeTotalsData'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.ResponseWithMetadata-1_Insights.Api.Models.Data.Entities.LoadShapeTotalsData'
'400':
description: Error with query parameters - see response for details
'429':
description: Too many requests
'500':
description: Server error - please try again later
operationId: getLssLoadShapeTotals
x-operation-id-source: derived
/lss/load-shape-totals/stream:
get:
tags:
- Load Shape
summary: Load shape totals data stream (IF023)
description: 'This endpoint provides a stream of load shape totals (IF023) data for a specified date range.
For more information on Load shape data & load shape categories please view the
LSS method statement.
Date parameters must be provided in the exact format yyyy-MM-dd.'
parameters:
- name: fromDate
in: query
description: The settlement date range start (inclusive). This must be in the format yyyy-MM-dd.
required: true
schema:
type: string
format: date
example: '2026-03-01'
example: '2026-03-01'
- name: toDate
in: query
description: The settlement date range end (inclusive). This must be in the format yyyy-MM-dd.
required: true
schema:
type: string
format: date
example: '2026-03-31'
example: '2026-03-31'
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Data.Entities.LoadShapeTotalsData'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Data.Entities.LoadShapeTotalsData'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Data.Entities.LoadShapeTotalsData'
'400':
description: Error with query parameters - see response for details
'429':
description: Too many requests
'500':
description: Server error - please try again later
operationId: getLssLoadShapeTotalsStream
x-operation-id-source: derived
components:
schemas:
Insights.Api.Models.Responses.ResponseWithMetadata-1_Insights.Api.Models.Data.Entities.LoadShapeTotalsData:
type: object
properties:
data:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/Insights.Api.Models.Data.Entities.LoadShapeTotalsData'
metadata:
$ref: '#/components/schemas/Insights.Api.Models.Metadata.ApiResponseSourceMetadata'
additionalProperties: false
Insights.Api.Models.Data.Entities.LoadShapeTotalsData:
type: object
properties:
sourceFileName:
type:
- string
- 'null'
sourceFileDatetime:
type: string
format: date-time
settlementDate:
type: string
format: date
gspGroupId:
type:
- string
- 'null'
connectionTypeIndicator:
type:
- string
- 'null'
marketSegmentIndicator:
type:
- string
- 'null'
domesticPremiseIndicator:
type:
- string
- 'null'
measurementQuantityId:
type:
- string
- 'null'
runNumber:
type: integer
format: int32
eventCode:
type:
- string
- 'null'
settlementPeriodDuration:
type: integer
format: int32
loadShapeDayTotal:
type: number
format: double
loadShapeDayPeakTotal:
type:
- number
- 'null'
format: double
loadShapeDayOffPeakTotal:
type:
- number
- 'null'
format: double
loadShape7DayRollingTotal:
type: number
format: double
loadShape7DayRollingPeakTotal:
type:
- number
- 'null'
format: double
loadShape7DayRollingOffPeakTotal:
type:
- number
- 'null'
format: double
loadShapeRollingAnnualTotal:
type: number
format: double
additionalProperties: false
Insights.Api.Models.Metadata.ApiResponseSourceMetadata:
type: object
properties:
datasets:
type:
- array
- 'null'
items:
type: string
example:
- DATASET
additionalProperties: false
Insights.Api.Models.Responses.ResponseWithMetadata-1_Insights.Api.Models.Data.Entities.LoadShapePeriodData:
type: object
properties:
data:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/Insights.Api.Models.Data.Entities.LoadShapePeriodData'
metadata:
$ref: '#/components/schemas/Insights.Api.Models.Metadata.ApiResponseSourceMetadata'
additionalProperties: false
Insights.Api.Models.Data.Entities.LoadShapePeriodData:
type: object
properties:
sourceFileName:
type:
- string
- 'null'
sourceFileDatetime:
type: string
format: date-time
settlementDate:
type: string
format: date
settlementPeriodStartDateTime:
type: string
format: date-time
settlementPeriodEndDateTime:
type: string
format: date-time
settlementPeriod:
type: integer
format: int32
gspGroupId:
type:
- string
- 'null'
connectionTypeIndicator:
type:
- string
- 'null'
marketSegmentIndicator:
type:
- string
- 'null'
domesticPremiseIndicator:
type:
- string
- 'null'
measurementQuantityId:
type:
- string
- 'null'
runNumber:
type: integer
format: int32
eventCode:
type:
- string
- 'null'
settlementPeriodDuration:
type: integer
format: int32
loadShapePeriodValue:
type: number
format: double
defaultLoadShapeFlag:
type:
- string
- 'null'
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)