openapi: 3.0.4
info:
title: Insights.Api Balancing Mechanism Dynamic BMRS Datasets API
version: '1.0'
description: Dynamic data.
servers:
- url: https://data.elexon.co.uk/bmrs/api/v1
tags:
- name: BMRS Datasets
description: Raw datasets as received from the National Grid, with associated metadata. The output in JSON format matches IRIS, and can be used interchangeably with IRIS output.
paths:
/datasets/NONBM:
get:
tags:
- BMRS Datasets
summary: Non-BM STOR (NONBM)
description: "This endpoint provides data about the Short Term Operating Reserves (STOR) that have been made use of\nby NGESO. This is activity that is outside of the Balancing Mechanism and takes place to meet the need to\nincrease generation or decrease demand.\n \nTo retrieve data from a particular time window, use the optional start and end time parameters.\nThese times should be expressed as defined within\nRFC 3339.\nIf no time window is chosen, the default output will be the latest published data."
parameters:
- name: from
in: query
description: The start of the data publish time window.
schema:
type: string
format: date-time
example: 2022-06-25T13:15Z
example: 2022-06-25T13:15Z
- name: to
in: query
description: The end of the data publish time window.
schema:
type: string
format: date-time
example: 2022-06-27T19:45Z
example: 2022-06-27T19:45Z
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.NonBmStorData'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.NonBmStorData'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.NonBmStorData'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.NonBmStorData'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.NonBmStorData'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.NonBmStorData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/NONBM/stream:
get:
tags:
- BMRS Datasets
summary: Non-BM STOR (NONBM) stream
description: "This endpoint provides data about the Short Term Operating Reserves (STOR) that have been made use of\nby NGESO. This is activity that is outside of the Balancing Mechanism and takes place to meet the need to\nincrease generation or decrease demand.\n \nTo retrieve data from a particular time window, use the optional start and end time parameters.\nThese times should be expressed as defined within\nRFC 3339.\nIf no time window is chosen, the default output will be the latest published data.\n \nThis endpoint has an optimised JSON payload and is aimed at frequent requests for the Non-BM STOR data."
parameters:
- name: from
in: query
description: The start of the data publish time window.
schema:
type: string
format: date-time
example: 2022-06-25T13:15Z
example: 2022-06-25T13:15Z
- name: to
in: query
description: The end of the data publish time window.
schema:
type: string
format: date-time
example: 2022-06-27T19:45Z
example: 2022-06-27T19:45Z
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Generation.DatasetRows.NonBmStorData'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Generation.DatasetRows.NonBmStorData'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Generation.DatasetRows.NonBmStorData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/PN:
get:
tags:
- BMRS Datasets
summary: Physical Notifications (PN)
description: "This endpoint provides Physical Notification data received from NGESO. It returns the data valid for a single settlement period.\nA Physical Notification is the best estimate of the level of generation or demand that a participant in the BM expects a BM Unit to export or import, respectively, in a Settlement Period.\n \nPhysical Notifications are submitted as a series of point MW values.\n \nThe settlement period to query must be specified as a date and settlement period. The date should be provided in the format yyyy-MM-dd."
parameters:
- name: settlementDate
in: query
description: The settlement date to query. This must be in the format yyyy-MM-dd.
required: true
schema:
type: string
format: date
example: '2022-07-01'
example: '2022-07-01'
- name: settlementPeriod
in: query
description: The settlement period to query. This should be an integer from 1-50 inclusive.
required: true
schema:
type: integer
format: int32
example: 5
example: 5
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- T_ABRBO-1
example:
- T_ABRBO-1
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.PhysicalNotificationData'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.PhysicalNotificationData'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.PhysicalNotificationData'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.PhysicalNotificationData'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.PhysicalNotificationData'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.PhysicalNotificationData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/PN/stream:
get:
tags:
- BMRS Datasets
summary: Physical Notifications (PN) stream
description: "This endpoint provides Physical Notification data received from NGESO.\nA Physical Notification is the best estimate of the level of generation or demand that a participant in the BM expects a BM Unit to export or import, respectively, in a Settlement Period.\n \nPhysical Notifications are submitted as a series of point MW values.\n \nThe settlement period to query can be specified as a date and settlement period, or as a datetime\nwhich will resolve to the settlement period that time falls within.\nIf a settlement period is provided, it will take precedence over the time portion of the datetime.\n\nSome examples of date parameter combinations are shown below.\n \nFiltering from settlement datetime to settlement datetime:\n \n /datasets/PN/stream?from=2022-07-01T00:00Z&to=2022-07-03T06:00Z\n \nFiltering from settlement datetime to settlement date and period:\n \n /datasets/PN/stream?from=2022-07-01T00:00Z&to=2022-07-03&settlementPeriodTo=15\n \nFiltering from settlement date and period to settlement datetime:\n \n /datasets/PN/stream?from=2022-07-01&settlementPeriodFrom=3&to=2022-07-03T06:00Z\n \nFiltering from settlement date and period to settlement date and period:\n \n /datasets/PN/stream?from=2022-07-01&settlementPeriodFrom=3&to=2022-07-03&settlementPeriodTo=15\n\nThis endpoint has an optimised JSON payload and is aimed at frequent requests for PN data."
parameters:
- name: from
in: query
description: The settlement date to query from.
required: true
schema:
type: string
format: date-time
example: '2022-07-01'
example: '2022-07-01'
- name: to
in: query
description: The settlement date to query up to.
required: true
schema:
type: string
format: date-time
example: '2022-07-03'
example: '2022-07-03'
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
example: 3
example: 3
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
example: 15
example: 15
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- T_ABRBO-1
example:
- T_ABRBO-1
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.PhysicalNotificationData'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.PhysicalNotificationData'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.PhysicalNotificationData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/QPN:
get:
tags:
- BMRS Datasets
summary: Quiescent Physical Notifications (QPN)
description: "This endpoint provides Quiescent Physical Notification data received from NGESO. It returns the data valid for a single settlement period.\nQuiescent Physical Notifications describe the MW levels to be deducted from the Physical Notification of a BM Unit to determine a resultant operating level.\n \nThe settlement period to query must be specified as a date and settlement period. The date should be provided in the format yyyy-MM-dd."
parameters:
- name: settlementDate
in: query
description: The settlement date to query. This must be in the format yyyy-MM-dd.
required: true
schema:
type: string
format: date
example: '2022-07-01'
example: '2022-07-01'
- name: settlementPeriod
in: query
description: The settlement period to query. This should be an integer from 1-50 inclusive.
required: true
schema:
type: integer
format: int32
example: 5
example: 5
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- T_ABRBO-1
example:
- T_ABRBO-1
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.PhysicalNotificationData'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.PhysicalNotificationData'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.PhysicalNotificationData'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.PhysicalNotificationData'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.PhysicalNotificationData'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.PhysicalNotificationData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/QPN/stream:
get:
tags:
- BMRS Datasets
summary: Quiescent Physical Notifications (QPN) stream
description: "This endpoint provides Quiescent Physical Notification data received from NGESO.\nQuiescent Physical Notifications describe the MW levels to be deducted from the Physical Notification of a BM Unit to determine a resultant operating level.\n \nThe settlement period to query can be specified as a date and settlement period, or as a datetime\nwhich will resolve to the settlement period that time falls within.\nIf a settlement period is provided, it will take precedence over the time portion of the datetime.\n\nSome examples of date parameter combinations are shown below.\n \nFiltering from settlement datetime to settlement datetime:\n \n /datasets/QPN/stream?from=2022-07-01T00:00Z&to=2022-07-03T06:00Z\n \nFiltering from settlement datetime to settlement date and period:\n \n /datasets/QPN/stream?from=2022-07-01T00:00Z&to=2022-07-03&settlementPeriodTo=15\n \nFiltering from settlement date and period to settlement datetime:\n \n /datasets/QPN/stream?from=2022-07-01&settlementPeriodFrom=3&to=2022-07-03T06:00Z\n \nFiltering from settlement date and period to settlement date and period:\n \n /datasets/QPN/stream?from=2022-07-01&settlementPeriodFrom=3&to=2022-07-03&settlementPeriodTo=15\n\nThis endpoint has an optimised JSON payload and is aimed at frequent requests for QPN data."
parameters:
- name: from
in: query
description: The settlement date to query from.
required: true
schema:
type: string
format: date-time
example: '2022-07-01'
example: '2022-07-01'
- name: to
in: query
description: The settlement date to query up to.
required: true
schema:
type: string
format: date-time
example: '2022-07-03'
example: '2022-07-03'
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
example: 3
example: 3
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
example: 15
example: 15
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- T_ABRBO-1
example:
- T_ABRBO-1
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.PhysicalNotificationData'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.PhysicalNotificationData'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.PhysicalNotificationData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/MELS:
get:
tags:
- BMRS Datasets
summary: Maximum Export Limit (MELS)
description: "This endpoint provides Maximum Export Limit data received from NGESO.\n\nThe Maximum Export Limit is the maximum power export level of a particular BM Unit at a particular time.\nThe data is updated every 30 minutes and within 15 minutes of the end of the effective Settlement Period.\nMELs are submitted as a series of MW values and associated times in UTC.\n\nBy default, the from and to parameters filter the data by time inclusively. If the settlementPeriodFrom or\nsettlementPeriodTo parameters are provided, the corresponding from or to parameter instead filters on settlement\ndate, allowing for searching by a combination of time and/or settlement date & settlement period.\nNote: When filtering via settlement date, from/to are treated as Dates only, with the time being ignored. For\nexample, 2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.\n \nAll Dates and DateTimes should be expressed as defined within\nRFC 3339.\n \nSome examples of date parameter combinations are shown below.\n \nFiltering from start time to start time:\n \n /datasets/mels?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z\n \nFiltering from start time to settlement date and period:\n \n /datasets/mels?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodTo=1\n \nFiltering from settlement date and period to start time:\n \n /datasets/mels?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1\n \nFiltering from settlement date and period to settlement date and period:\n \n /datasets/mels?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1"
parameters:
- name: from
in: query
description: The "from" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-10-12T00:00Z
example: 2022-10-12T00:00Z
- name: to
in: query
description: The "to" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-10-12T01:00Z
example: 2022-10-12T01:00Z
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- T_DRAXX-1
example:
- T_DRAXX-1
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.DeliveryLimitMaxData'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.DeliveryLimitMaxData'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.DeliveryLimitMaxData'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.DeliveryLimitMaxData'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.DeliveryLimitMaxData'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.DeliveryLimitMaxData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/MELS/stream:
get:
tags:
- BMRS Datasets
summary: Maximum Export Limit (MELS) stream
description: "This endpoint provides Maximum Export Limit data received from NGESO.\n\nThe Maximum Export Limit is the maximum power export level of a particular BM Unit at a particular time.\nThe data is updated every 30 minutes and within 15 minutes of the end of the effective Settlement Period.\nMELs are submitted as a series of MW values and associated times in UTC.\n\nBy default, the from and to parameters filter the data by time inclusively. If the settlementPeriodFrom or\nsettlementPeriodTo parameters are provided, the corresponding from or to parameter instead filters on settlement\ndate, allowing for searching by a combination of time and/or settlement date & settlement period.\nNote: When filtering via settlement date, from/to are treated as Dates only, with the time being ignored. For\nexample, 2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.\n \nAll Dates and DateTimes should be expressed as defined within\nRFC 3339.\n \nSome examples of date parameter combinations are shown below.\n \nFiltering from start time to start time:\n \n /datasets/mels/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z\n \nFiltering from start time to settlement date and period:\n \n /datasets/mels/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodTo=1\n \nFiltering from settlement date and period to start time:\n \n /datasets/mels/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1\n \nFiltering from settlement date and period to settlement date and period:\n \n /datasets/mels/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1\nThis endpoint has an optimised JSON payload and is aimed at frequent requests for MELS data."
parameters:
- name: from
in: query
description: The "from" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-10-12T00:00Z
example: 2022-10-12T00:00Z
- name: to
in: query
description: The "to" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-10-12T01:00Z
example: 2022-10-12T01:00Z
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- T_DRAXX-1
example:
- T_DRAXX-1
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.DeliveryLimitMaxData'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.DeliveryLimitMaxData'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.DeliveryLimitMaxData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/MILS:
get:
tags:
- BMRS Datasets
summary: Maximum Import Limit (MILS)
description: "This endpoint provides Maximum Import Limit data received from NGESO.\n\nThe maximum power import level of a particular BM Unit at a particular time.\nThe data is updated every 30 minutes and within 15 minutes of the end of the effective Settlement Period.\nMILs are submitted as a series of MW values and associated times in UTC.\n\nBy default, the from and to parameters filter the data by time inclusively. If the settlementPeriodFrom or\nsettlementPeriodTo parameters are provided, the corresponding from or to parameter instead filters on settlement\ndate, allowing for searching by a combination of time and/or settlement date & settlement period.\nNote: When filtering via settlement date, from/to are treated as Dates only, with the time being ignored. For\nexample, 2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.\n \nAll Dates and DateTimes should be expressed as defined within\nRFC 3339.\n \nSome examples of date parameter combinations are shown below.\n \nFiltering from start time to start time:\n \n /datasets/mils?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z\n \nFiltering from start time to settlement date and period:\n \n /datasets/mils?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodTo=1\n \nFiltering from settlement date and period to start time:\n \n /datasets/mils?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1\n \nFiltering from settlement date and period to settlement date and period:\n \n /datasets/mils?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1"
parameters:
- name: from
in: query
description: The "from" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-10-12T00:00Z
example: 2022-10-12T00:00Z
- name: to
in: query
description: The "to" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-10-12T01:00Z
example: 2022-10-12T01:00Z
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- T_DRAXX-1
example:
- T_DRAXX-1
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.DeliveryLimitMaxData'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.DeliveryLimitMaxData'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.DeliveryLimitMaxData'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.DeliveryLimitMaxData'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.DeliveryLimitMaxData'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.DeliveryLimitMaxData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/MILS/stream:
get:
tags:
- BMRS Datasets
summary: Maximum Import Limit (MILS) stream
description: "This endpoint provides Maximum Import Limit data received from NGESO.\n\nThe maximum power import level of a particular BM Unit at a particular time.\nThe data is updated every 30 minutes and within 15 minutes of the end of the effective Settlement Period.\nMILs are submitted as a series of MW values and associated times in UTC.\n\nBy default, the from and to parameters filter the data by time inclusively. If the settlementPeriodFrom or\nsettlementPeriodTo parameters are provided, the corresponding from or to parameter instead filters on settlement\ndate, allowing for searching by a combination of time and/or settlement date & settlement period.\nNote: When filtering via settlement date, from/to are treated as Dates only, with the time being ignored. For\nexample, 2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.\n \nAll Dates and DateTimes should be expressed as defined within\nRFC 3339.\n \nSome examples of date parameter combinations are shown below.\n \nFiltering from start time to start time:\n \n /datasets/mils/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z\n \nFiltering from start time to settlement date and period:\n \n /datasets/mils/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodTo=1\n \nFiltering from settlement date and period to start time:\n \n /datasets/mils/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1\n \nFiltering from settlement date and period to settlement date and period:\n \n /datasets/mils/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1\nThis endpoint has an optimised JSON payload and is aimed at frequent requests for MILS data."
parameters:
- name: from
in: query
description: The "from" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-10-12T00:00Z
example: 2022-10-12T00:00Z
- name: to
in: query
description: The "to" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-10-12T01:00Z
example: 2022-10-12T01:00Z
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- T_DRAXX-1
example:
- T_DRAXX-1
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.DeliveryLimitMaxData'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.DeliveryLimitMaxData'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.DeliveryLimitMaxData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/QAS:
get:
tags:
- BMRS Datasets
summary: Balancing Services Volume (QAS)
description: "This endpoint provides Balancing Services Volume data received from NGESO.\n \nBalancing Services Volume is a volume which is received from the System Operator, which represents the volume\nof energy (MWh) associated with the provision of Applicable Balancing Services for each relevant BM Unit and\nSettlement Period.\n\nQAS can be positive or negative and is normally only provided where there is a non-zero volume.\n \nBy default, the from and to parameters filter the data by time inclusively. If the settlementPeriodFrom or\nsettlementPeriodTo parameters are provided, the corresponding from or to parameter instead filters on settlement\ndate, allowing for searching by a combination of time and/or settlement date & settlement period.\nNote: When filtering via settlement date, from/to are treated as Dates only, with the time being ignored. For\nexample, 2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.\n \nAll Dates and DateTimes should be expressed as defined within\nRFC 3339.\n \nSome examples of date parameter combinations are shown below.\n \nFiltering from start time to start time:\n \n /datasets/qas?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z\n \nFiltering from start time to settlement date and period:\n \n /datasets/qas?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodTo=1\n \nFiltering from settlement date and period to start time:\n \n /datasets/qas?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1\n \nFiltering from settlement date and period to settlement date and period:\n \n /datasets/qas?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1"
parameters:
- name: from
in: query
description: The "from" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-12T00:00Z
example: 2022-08-12T00:00Z
- name: to
in: query
description: The "to" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-13T00:00Z
example: 2022-08-13T00:00Z
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- T_CNQPS-1
example:
- T_CNQPS-1
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.BalancingServicesVolumeData'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.BalancingServicesVolumeData'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.BalancingServicesVolumeData'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.BalancingServicesVolumeData'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.BalancingServicesVolumeData'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.BalancingServicesVolumeData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/QAS/stream:
get:
tags:
- BMRS Datasets
summary: Balancing Services Volume (QAS) stream
description: "This endpoint provides Balancing Services Volume data received from NGESO.\n \nBalancing Services Volume is a volume which is received from the System Operator, which represents the volume\nof energy (MWh) associated with the provision of Applicable Balancing Services for each relevant BM Unit and\nSettlement Period.\n\nQAS can be positive or negative and is normally only provided where there is a non-zero volume.\n \nBy default, the from and to parameters filter the data by time inclusively. If the settlementPeriodFrom or\nsettlementPeriodTo parameters are provided, the corresponding from or to parameter instead filters on settlement\ndate, allowing for searching by a combination of time and/or settlement date & settlement period.\nNote: When filtering via settlement date, from/to are treated as Dates only, with the time being ignored. For\nexample, 2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.\n \nAll Dates and DateTimes should be expressed as defined within\nRFC 3339.\n \nSome examples of date parameter combinations are shown below.\n \nFiltering from start time to start time:\n \n /datasets/qas/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z\n \nFiltering from start time to settlement date and period:\n \n /datasets/qas/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodTo=1\n \nFiltering from settlement date and period to start time:\n \n /datasets/qas/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1\n \nFiltering from settlement date and period to settlement date and period:\n \n /datasets/qas/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1\n\nThis endpoint has an optimised JSON payload and is aimed at frequent requests for QAS data."
parameters:
- name: from
in: query
description: The "from" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-12T00:00Z
example: 2022-08-12T00:00Z
- name: to
in: query
description: The "to" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-13T00:00Z
example: 2022-08-13T00:00Z
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- T_CNQPS-1
example:
- T_CNQPS-1
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.DatasetRows.BalancingServicesVolumeData'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.DatasetRows.BalancingServicesVolumeData'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.DatasetRows.BalancingServicesVolumeData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/NETBSAD:
get:
tags:
- BMRS Datasets
summary: Net Balancing Services Adjustment Data (NETBSAD)
description: "This endpoint provides Net Balancing Services Adjustment data received from NGESO.\n \nNet Balancing Services Adjustment data covers the buy/sell price, cost and volume adjustments for each\nsettlement period. \n \nBy default, the from and to parameters filter the data by time inclusively. If the settlementPeriodFrom or\nsettlementPeriodTo parameters are provided, the corresponding from or to parameter instead filters on settlement\ndate, allowing for searching by a combination of time and/or settlement date & settlement period.\nNote: When filtering via settlement date, from/to are treated as Dates only, with the time being ignored. For\nexample, 2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.\n \nAll Dates and DateTimes should be expressed as defined within\nRFC 3339.\n \nSome examples of date parameter combinations are shown below.\n \nFiltering from start time to start time:\n \n /datasets/netbsad?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z\n \nFiltering from start time to settlement date and period:\n \n /datasets/netbsad?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodTo=1\n \nFiltering from settlement date and period to start time:\n \n /datasets/netbsad?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1\n \nFiltering from settlement date and period to settlement date and period:\n \n /datasets/netbsad?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1"
parameters:
- name: from
in: query
description: The "from" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-10-10T00:00Z
example: 2022-10-10T00:00Z
- name: to
in: query
description: The "to" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-10-17T00:00Z
example: 2022-10-17T00:00Z
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.NetBalancingServicesAdjustmentData'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.NetBalancingServicesAdjustmentData'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.NetBalancingServicesAdjustmentData'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.NetBalancingServicesAdjustmentData'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.NetBalancingServicesAdjustmentData'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.NetBalancingServicesAdjustmentData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/NETBSAD/stream:
get:
tags:
- BMRS Datasets
summary: Net Balancing Services Adjustment Data (NETBSAD)
description: "This endpoint provides Net Balancing Services Adjustment data received from NGESO.\n \nNet Balancing Services Adjustment data covers the buy/sell price, cost and volume adjustments for each\nsettlement period. \n \nBy default, the from and to parameters filter the data by time inclusively. If the settlementPeriodFrom or\nsettlementPeriodTo parameters are provided, the corresponding from or to parameter instead filters on settlement\ndate, allowing for searching by a combination of time and/or settlement date & settlement period.\nNote: When filtering via settlement date, from/to are treated as Dates only, with the time being ignored. For\nexample, 2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.\n \nAll Dates and DateTimes should be expressed as defined within\nRFC 3339.\n \nSome examples of date parameter combinations are shown below.\n \nFiltering from start time to start time:\n \n /datasets/netbsad/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z\n \nFiltering from start time to settlement date and period:\n \n /datasets/netbsad/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodTo=1\n \nFiltering from settlement date and period to start time:\n \n /datasets/netbsad/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1\n \nFiltering from settlement date and period to settlement date and period:\n \n /datasets/netbsad/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1\n\nThis endpoint has an optimised JSON payload and is aimed at frequent requests for NETBSAD data."
parameters:
- name: from
in: query
description: The "from" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-10-10T00:00Z
example: 2022-10-10T00:00Z
- name: to
in: query
description: The "to" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-10-17T00:00Z
example: 2022-10-17T00:00Z
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.DatasetRows.NetBalancingServicesAdjustmentData'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.DatasetRows.NetBalancingServicesAdjustmentData'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.DatasetRows.NetBalancingServicesAdjustmentData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/DISBSAD:
get:
tags:
- BMRS Datasets
summary: Disaggregated Balancing Services Adjustment Data (DISBSAD)
description: "This endpoint provides Disaggregated Balancing Services Adjustment data received from NGESO.\n \nDisaggregated Balancing Services Adjustment data covers a set of adjustment actions, cost and volume values\nfor each Settlement Period. Adjustment costs are shown in £. Adjustment volumes are shown in MWh.\n \nBy default, the from and to parameters filter the data by time inclusively. If the settlementPeriodFrom or\nsettlementPeriodTo parameters are provided, the corresponding from or to parameter instead filters on settlement\ndate, allowing for searching by a combination of time and/or settlement date & settlement period.\nNote: When filtering via settlement date, from/to are treated as Dates only, with the time being ignored. For\nexample, 2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.\n \nAll Dates and DateTimes should be expressed as defined within\nRFC 3339.\n \nSome examples of date parameter combinations are shown below.\n \nFiltering from start time to start time:\n \n /datasets/disbsad?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z\n \nFiltering from start time to settlement date and period:\n \n /datasets/disbsad?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodTo=1\n \nFiltering from settlement date and period to start time:\n \n /datasets/disbsad?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1\n \nFiltering from settlement date and period to settlement date and period:\n \n /datasets/disbsad?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1"
parameters:
- name: from
in: query
description: The "from" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-10-10T00:00Z
example: 2022-10-10T00:00Z
- name: to
in: query
description: The "to" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-10-11T00:00Z
example: 2022-10-11T00:00Z
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.DisaggregatedBalancingServicesAdjustmentData'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.DisaggregatedBalancingServicesAdjustmentData'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.DisaggregatedBalancingServicesAdjustmentData'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.DisaggregatedBalancingServicesAdjustmentData'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.DisaggregatedBalancingServicesAdjustmentData'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.DisaggregatedBalancingServicesAdjustmentData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/DISBSAD/stream:
get:
tags:
- BMRS Datasets
summary: Disaggregated Balancing Services Adjustment Data (DISBSAD) stream
description: "This endpoint provides Disaggregated Balancing Services Adjustment data received from NGESO.\n \nDisaggregated Balancing Services Adjustment data covers a set of adjustment actions, cost and volume values\nfor each Settlement Period. Adjustment costs are shown in £. Adjustment volumes are shown in MWh.\n \nBy default, the from and to parameters filter the data by time inclusively. If the settlementPeriodFrom or\nsettlementPeriodTo parameters are provided, the corresponding from or to parameter instead filters on settlement\ndate, allowing for searching by a combination of time and/or settlement date & settlement period.\nNote: When filtering via settlement date, from/to are treated as Dates only, with the time being ignored. For\nexample, 2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.\n \nAll Dates and DateTimes should be expressed as defined within\nRFC 3339.\n \nSome examples of date parameter combinations are shown below.\n \nFiltering from start time to start time:\n \n /datasets/disbsad/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z\n \nFiltering from start time to settlement date and period:\n \n /datasets/disbsad/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodTo=1\n \nFiltering from settlement date and period to start time:\n \n /datasets/disbsad/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1\n \nFiltering from settlement date and period to settlement date and period:\n \n /datasets/disbsad/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1\n\nThis endpoint has an optimised JSON payload and is aimed at frequent requests for DISBSAD data."
parameters:
- name: from
in: query
description: The "from" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-10-10T00:00Z
example: 2022-10-10T00:00Z
- name: to
in: query
description: The "to" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-10-11T00:00Z
example: 2022-10-11T00:00Z
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.DatasetRows.DisaggregatedBalancingServicesAdjustmentData'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.DatasetRows.DisaggregatedBalancingServicesAdjustmentData'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.DatasetRows.DisaggregatedBalancingServicesAdjustmentData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/BOD:
get:
tags:
- BMRS Datasets
summary: Bid Offer Data (BOD)
description: "This endpoint provides bid-offer data.\n \nBy default, the from and to parameters filter the data inclusively and this endpoint will return any data where\nTimeFrom is within the requested time range. If the settlementPeriodFrom or settlementPeriodTo parameters are\nprovided, it will instead filter to return any data where TimeFrom is within the specified range of settlement\nperiods. It is possible to search using a combination of time and/or settlement date & settlement period.\nNote: When filtering via settlement date, from/to are treated as Dates only, with the time being ignored.\nFor example, 2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.\n \nAll Dates and DateTimes should be expressed as defined within\nRFC 3339.\n \nSome examples of date parameter combinations are shown below.\n \nFiltering from a datetime to a datetime\n \n /datasets/bod?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z\n \nFiltering from a datetime to a settlement date and period:\n \n /datasets/bod?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodTo=1\n \nFiltering from a settlement date and period to a datetime:\n \n /datasets/bod?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1\n \nFiltering from a settlement date and period to a settlement date and period:\n \n /datasets/bod?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1"
parameters:
- name: from
in: query
description: The "from" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-09-22T00:00Z
example: 2022-09-22T00:00Z
- name: to
in: query
description: The "to" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-09-22T01:00Z
example: 2022-09-22T01:00Z
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- 2__HFLEX001
example:
- 2__HFLEX001
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.BidOfferDatasetResponse'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.BidOfferDatasetResponse'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.BidOfferDatasetResponse'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.BidOfferDatasetResponse'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.BidOfferDatasetResponse'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.BidOfferDatasetResponse'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/BOD/stream:
get:
tags:
- BMRS Datasets
summary: Bid-Offer Data (BOD) stream
description: "This endpoint provides bid-offer data.\n \nBy default, the from and to parameters filter the data inclusively and this endpoint will return any data where\nTimeFrom is within the requested time range. If the settlementPeriodFrom or settlementPeriodTo parameters are\nprovided, it will instead filter to return any data where TimeFrom is within the specified range of settlement\nperiods. It is possible to search using a combination of time and/or settlement date & settlement period.\nNote: When filtering via settlement date, from/to are treated as Dates only, with the time being ignored.\nFor example, 2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.\n \nAll Dates and DateTimes should be expressed as defined within\nRFC 3339.\n \nSome examples of date parameter combinations are shown below.\n \nFiltering from datetime to datetime\n \n /datasets/bod/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z\n \nFiltering from datetime to settlement date and period:\n \n /datasets/bod/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodTo=1\n \nFiltering from settlement date and period to datetime:\n \n /datasets/bod/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1\n \nFiltering from settlement date and period to settlement date and period:\n \n /datasets/bod/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1"
parameters:
- name: from
in: query
description: The "from" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-09-22T00:00Z
example: 2022-09-22T00:00Z
- name: to
in: query
description: The "to" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-09-22T01:00Z
example: 2022-09-22T01:00Z
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- 2__HFLEX001
example:
- 2__HFLEX001
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.DatasetRows.BidOfferDatasetResponse'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.DatasetRows.BidOfferDatasetResponse'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.DatasetRows.BidOfferDatasetResponse'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/BOALF:
get:
tags:
- BMRS Datasets
summary: Bid Offer Acceptance Level Flagged (BOALF)
description: "This endpoint provides bid offer acceptance data.\n \nBy default, the from and to parameters filter the data inclusively and this endpoint will return any data where\nTimeFrom is within the requested time range. If the settlementPeriodFrom or settlementPeriodTo parameters are\nprovided, it will instead filter to return any data where TimeFrom is within the specified range of settlement\nperiods. It is possible to search using a combination of time and/or settlement date & settlement period.\nNote: When filtering via settlement date, from/to are treated as Dates only, with the time being ignored.\nFor example, 2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.\n \nAll Dates and DateTimes should be expressed as defined within\nRFC 3339.\n \nSome examples of date parameter combinations are shown below.\n \nFiltering from datetime to datetime\n \n /datasets/boalf?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z\n \nFiltering from datetime to settlement date and period:\n \n /datasets/boalf?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodTo=1\n \nFiltering from settlement date and period to datetime:\n \n /datasets/boalf?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1\n \nFiltering from settlement date and period to settlement date and period:\n \n /datasets/boalf?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1"
parameters:
- name: from
in: query
description: The "from" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-10-22T00:00Z
example: 2022-10-22T00:00Z
- name: to
in: query
description: The "to" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-10-23T00:00Z
example: 2022-10-23T00:00Z
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- T_WBURB-3
example:
- T_WBURB-3
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.BidOfferAcceptanceLevelDatasetResponse'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.BidOfferAcceptanceLevelDatasetResponse'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.BidOfferAcceptanceLevelDatasetResponse'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.BidOfferAcceptanceLevelDatasetResponse'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.BidOfferAcceptanceLevelDatasetResponse'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.BidOfferAcceptanceLevelDatasetResponse'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/BOALF/stream:
get:
tags:
- BMRS Datasets
summary: Bid Offer Acceptance Level Flagged (BOALF) stream
description: "This endpoint provides bid offer acceptance data.\n \nBy default, the from and to parameters filter the data inclusively and this endpoint will return any data where\nTimeFrom is within the requested time range. If the settlementPeriodFrom or settlementPeriodTo parameters are\nprovided, it will instead filter to return any data where TimeFrom is within the specified range of settlement\nperiods. It is possible to search using a combination of time and/or settlement date & settlement period.\nNote: When filtering via settlement date, from/to are treated as Dates only, with the time being ignored.\nFor example, 2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.\n \nAll Dates and DateTimes should be expressed as defined within\nRFC 3339.\n \nSome examples of date parameter combinations are shown below.\n \nFiltering from datetime to datetime\n \n /datasets/boalf/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z\n \nFiltering from datetime to settlement date and period:\n \n /datasets/boalf/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodTo=1\n \nFiltering from settlement date and period to datetime:\n \n /datasets/boalf/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1\n \nFiltering from settlement date and period to settlement date and period:\n \n /datasets/boalf/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1"
parameters:
- name: from
in: query
description: The "from" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-10-22T00:00Z
example: 2022-10-22T00:00Z
- name: to
in: query
description: The "to" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-10-23T00:00Z
example: 2022-10-23T00:00Z
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- T_WBURB-3
example:
- T_WBURB-3
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.DatasetRows.BidOfferAcceptanceLevelDatasetResponse'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.DatasetRows.BidOfferAcceptanceLevelDatasetResponse'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.DatasetRows.BidOfferAcceptanceLevelDatasetResponse'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/MID:
get:
tags:
- BMRS Datasets
summary: Market Index Data (MID)
description: "This endpoint provides Market Index Data received from NGESO.\n \nMarket Index Data is a key component in the calculation of System Buy Price and System Sell Price for each\nSettlement Period. This data is received from each of the appointed Market Index Data Providers (MIDPs) and\nreflects the price of wholesale electricity in Great Britain in the short term markets. The Market Index Data\nwhich is received from each MIDP for each Settlement Period consists of a Market Index Volume and\nMarket Index Price, representing the volume and price of trading for the relevant period in the market operated\nby the MIDP. The Market Price (the volume weighed average Market Index Price) is used to derive\nthe Reverse Price (SBP or SSP).\"\n \nThe two data providers available to query are N2EX (\"N2EXMIDP\") and APX (\"APXMIDP\").\n\nBy default, the from and to parameters filter the data by time inclusively. If the settlementPeriodFrom or\nsettlementPeriodTo parameters are provided, the corresponding from or to parameter instead filters on settlement\ndate, allowing for searching by a combination of time and/or settlement date & settlement period.\nNote: When filtering via settlement date, from/to are treated as Dates only, with the time being ignored. For\nexample, 2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.\n \nAll Dates and DateTimes should be expressed as defined within\nRFC 3339.\n \nSome examples of date parameter combinations are shown below.\n \nFiltering from start time to start time:\n \n /datasets/mid?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z\n \nFiltering from start time to settlement date and period:\n \n /datasets/mid?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodTo=1\n \nFiltering from settlement date and period to start time:\n \n /datasets/mid?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1\n \nFiltering from settlement date and period to settlement date and period:\n \n /datasets/mid?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1"
parameters:
- name: from
in: query
description: The "from" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-12T00:00Z
example: 2022-08-12T00:00Z
- name: to
in: query
description: The "to" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-13T00:00Z
example: 2022-08-13T00:00Z
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: dataProviders
in: query
description: The data providers to query. If no data provider is selected both will be displayed.
schema:
type: array
items:
type: string
example:
- N2EXMIDP
example:
- N2EXMIDP
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.MarketIndexDatasetResponse'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.MarketIndexDatasetResponse'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.MarketIndexDatasetResponse'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.MarketIndexDatasetResponse'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.MarketIndexDatasetResponse'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.MarketIndexDatasetResponse'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/MID/stream:
get:
tags:
- BMRS Datasets
summary: Market Index Data (MID) stream
description: "This endpoint provides Market Index Data received from NGESO.\n \nMarket Index Data is a key component in the calculation of System Buy Price and System Sell Price for each\nSettlement Period. This data is received from each of the appointed Market Index Data Providers (MIDPs) and\nreflects the price of wholesale electricity in Great Britain in the short term markets. The Market Index Data\nwhich is received from each MIDP for each Settlement Period consists of a Market Index Volume and\nMarket Index Price, representing the volume and price of trading for the relevant period in the market operated\nby the MIDP. The Market Price (the volume weighed average Market Index Price) is used to derive\nthe Reverse Price (SBP or SSP).\"\n \nThe two data providers available to query are N2EX (\"N2EXMIDP\") and APX (\"APXMIDP\").\n\nBy default, the from and to parameters filter the data by time inclusively. If the settlementPeriodFrom or\nsettlementPeriodTo parameters are provided, the corresponding from or to parameter instead filters on settlement\ndate, allowing for searching by a combination of time and/or settlement date & settlement period.\nNote: When filtering via settlement date, from/to are treated as Dates only, with the time being ignored. For\nexample, 2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.\n \nAll Dates and DateTimes should be expressed as defined within\nRFC 3339.\n \nSome examples of date parameter combinations are shown below.\n \nFiltering from start time to start time:\n \n /datasets/mid/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z\n \nFiltering from start time to settlement date and period:\n \n /datasets/mid/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodTo=1\n \nFiltering from settlement date and period to start time:\n \n /datasets/mid/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1\n \nFiltering from settlement date and period to settlement date and period:\n \n /datasets/mid/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1\n\nThis endpoint has an optimised JSON payload and is aimed at frequent requests for MID data."
parameters:
- name: from
in: query
description: The "from" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-12T00:00Z
example: 2022-08-12T00:00Z
- name: to
in: query
description: The "to" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-13T00:00Z
example: 2022-08-13T00:00Z
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: dataProviders
in: query
description: The data providers to query. If no data provider is selected both will be displayed.
schema:
type: array
items:
type: string
example:
- N2EXMIDP
example:
- N2EXMIDP
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.DatasetRows.MarketIndexDatasetResponse'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.DatasetRows.MarketIndexDatasetResponse'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.DatasetRows.MarketIndexDatasetResponse'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/FUELHH:
get:
tags:
- BMRS Datasets
summary: Half-hourly generation outturn by fuel type (FUELHH)
description: "This endpoint provides the half-hourly generation outturn (Generation By Fuel type)\nto give our users an indication of the generation outturn for Great Britain.\nThe data is aggregated by Fuel Type category and updated at 30-minute intervals with\naverage MW values over 30 minutes for each category.\n \nThis endpoint includes additional settlement parameters such as Settlement Date and Settlement Period.\nThe Settlement Date fields cannot be set when a Publish Date field is set.\n \nSettlement date parameters must be provided in the exact format yyyy-MM-dd."
parameters:
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
example: '2022-06-25T00:00:00Z'
example: '2022-06-25T00:00:00Z'
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
example: '2022-06-26T00:00:00Z'
example: '2022-06-26T00:00:00Z'
- name: settlementDateFrom
in: query
schema:
type: string
format: date
example: '2022-09-20'
example: '2022-09-20'
- name: settlementDateTo
in: query
schema:
type: string
format: date
example: '2022-09-21'
example: '2022-09-21'
- name: settlementPeriod
in: query
description: List of Settlement Periods
schema:
uniqueItems: true
type: array
items:
type: integer
format: int32
example:
- 3
- 4
example:
- 3
- 4
- name: fuelType
in: query
description: Fuel Type e.g. NUCLEAR
schema:
type: array
items:
type: string
example:
- NUCLEAR
example:
- NUCLEAR
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AugmentedOutturnData'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AugmentedOutturnData'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AugmentedOutturnData'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AugmentedOutturnData'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AugmentedOutturnData'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AugmentedOutturnData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/FUELHH/stream:
get:
tags:
- BMRS Datasets
summary: Half-hourly generation outturn by fuel type (FUELHH) stream
description: "This endpoint provides the half-hourly generation outturn (Generation By Fuel type)\nto give our users an indication of the generation outturn for Great Britain.\nThe data is aggregated by Fuel Type category and updated at 30-minute intervals with\naverage MW values over 30 minutes for each category.\n \nThis endpoint includes additional settlement parameters such as Settlement Date and Settlement Period.\nThe Settlement Date fields cannot be set when a Publish Date field is set.\n \nSettlement date parameters must be provided in the exact format yyyy-MM-dd.\n \nThis endpoint has an optimised JSON payload and is aimed at frequent requests for the data."
parameters:
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
example: '2022-06-25T00:00:00Z'
example: '2022-06-25T00:00:00Z'
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
example: '2022-06-26T00:00:00Z'
example: '2022-06-26T00:00:00Z'
- name: settlementDateFrom
in: query
schema:
type: string
format: date
example: '2022-09-20'
example: '2022-09-20'
- name: settlementDateTo
in: query
schema:
type: string
format: date
example: '2022-09-21'
example: '2022-09-21'
- name: settlementPeriod
in: query
description: List of Settlement Periods
schema:
uniqueItems: true
type: array
items:
type: integer
format: int32
example:
- 3
- 4
example:
- 3
- 4
- name: fuelType
in: query
description: Fuel Type e.g. NUCLEAR
schema:
type: array
items:
type: string
example:
- NUCLEAR
example:
- NUCLEAR
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Generation.DatasetRows.AugmentedOutturnData'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Generation.DatasetRows.AugmentedOutturnData'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Generation.DatasetRows.AugmentedOutturnData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/FUELINST:
get:
tags:
- BMRS Datasets
summary: Instantaneous generation outturn by fuel type (FUELINST)
description: "This endpoint provides the instantaneous generation outturn (Generation By Fuel type)\nto give our users an indication of the generation outturn for Great Britain.\nThe data is aggregated by Fuel Type category and updated at five-minute intervals\nwith average MW values over 5 minutes for each category.\n \nThis endpoint includes additional settlement parameters such as Settlement Date and Settlement Period.\nThe Settlement Date fields cannot be set when a Publish Date field is set.\n \nSettlement date parameters must be provided in the exact format yyyy-MM-dd."
parameters:
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
example: '2022-06-20T00:00:00Z'
example: '2022-06-20T00:00:00Z'
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
example: '2022-06-26T00:00:00Z'
example: '2022-06-26T00:00:00Z'
- name: settlementDateFrom
in: query
schema:
type: string
format: date
example: '2022-09-20'
example: '2022-09-20'
- name: settlementDateTo
in: query
schema:
type: string
format: date
example: '2022-09-21'
example: '2022-09-21'
- name: settlementPeriod
in: query
description: List of Settlement Periods
schema:
uniqueItems: true
type: array
items:
type: integer
format: int32
example:
- 3
- 4
example:
- 3
- 4
- name: fuelType
in: query
description: Fuel Type e.g. NUCLEAR
schema:
type: array
items:
type: string
example:
- NUCLEAR
example:
- NUCLEAR
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AugmentedOutturnData'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AugmentedOutturnData'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AugmentedOutturnData'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AugmentedOutturnData'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AugmentedOutturnData'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AugmentedOutturnData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/FUELINST/stream:
get:
tags:
- BMRS Datasets
summary: Instantaneous generation outturn by fuel type (FUELINST) stream
description: "This endpoint provides the instantaneous generation outturn (Generation By Fuel type)\nto give our users an indication of the generation outturn for Great Britain.\nThe data is aggregated by Fuel Type category and updated at five-minute intervals\nwith average MW values over 5 minutes for each category.\n \nThis endpoint includes additional settlement parameters such as Settlement Date and Settlement Period.\nThe Settlement Date fields cannot be set when a Publish Date field is set.\n \nSettlement date parameters must be provided in the exact format yyyy-MM-dd.\n\nThis endpoint has an optimised JSON payload and is aimed at frequent requests for the data."
parameters:
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
example: '2022-06-20T00:00:00Z'
example: '2022-06-20T00:00:00Z'
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
example: '2022-06-26T00:00:00Z'
example: '2022-06-26T00:00:00Z'
- name: settlementDateFrom
in: query
schema:
type: string
format: date
example: '2022-09-20'
example: '2022-09-20'
- name: settlementDateTo
in: query
schema:
type: string
format: date
example: '2022-09-21'
example: '2022-09-21'
- name: settlementPeriod
in: query
description: List of Settlement Periods
schema:
uniqueItems: true
type: array
items:
type: integer
format: int32
example:
- 3
- 4
example:
- 3
- 4
- name: fuelType
in: query
description: Fuel Type e.g. NUCLEAR
schema:
type: array
items:
type: string
example:
- NUCLEAR
example:
- NUCLEAR
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Generation.DatasetRows.AugmentedOutturnData'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Generation.DatasetRows.AugmentedOutturnData'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Generation.DatasetRows.AugmentedOutturnData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/UOU2T14D:
get:
tags:
- BMRS Datasets
summary: 2 to 14 days ahead generation availability aggregated by Balancing Mechanism Units (UOU2T14D)
description: "This endpoint provides a forward view of availability (also referred to as Output Usable\ndata under the Grid Code) for generation and interconnector capacity, accounting for planned\noutages covering availability data from 2 days ahead to 14 days ahead; it is aggregated by\nNational Grid Balancing Mechanism Units (NGC BMUs).\n \nIn the context of this report, BMUs can be considered as generating units.\nElexon BMUs differs from NGC BMUs by including a prefix e.g. 'T_'.\nThe mapping between NGC and Elexon BMUs can be retrieved via reference data API endpoints."
parameters:
- name: fuelType
in: query
description: The fuel type to query. Add each fuel type separately. If no fuel types are supplied, all fuel types will be returned.
schema:
type: array
items:
type: string
example:
- WIND
example:
- WIND
- name: publishDateTimeFrom
in: query
description: 'Start of the Publish Time range to query. If specified, PublishDateTimeTo must also be specified.
If both are omitted, latest published data is returned.'
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
description: 'End of the Publish Time range to query. If specified, PublishDateTimeFrom must also be specified.
If both are omitted, latest published data is returned.'
schema:
type: string
format: date-time
- name: bmUnit
in: query
description: 'The BM units to query. Add each unit separately. Either the Elexon ID or the National Grid ID can be used.
If no BM unit is supplied all BM units will be returned.'
schema:
type: array
items:
type: string
example:
- WTMSO-1
example:
- WTMSO-1
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByBmUnitDaily'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByBmUnitDaily'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByBmUnitDaily'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByBmUnitDaily'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByBmUnitDaily'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByBmUnitDaily'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/UOU2T14D/stream:
get:
tags:
- BMRS Datasets
summary: 2 to 14 days ahead generation availability aggregated by Balancing Mechanism Units (UOU2T14D) stream
description: "This endpoint provides a forward view of availability (also referred to as Output Usable\ndata under the Grid Code) for generation and interconnector capacity, accounting for planned\noutages covering availability data from 2 days ahead to 14 days ahead; it is aggregated by\nNational Grid Balancing Mechanism Units (NGC BMUs).\n \nIn the context of this report, BMUs can be considered as generating units.\nElexon BMUs differs from NGC BMUs by including a prefix e.g. 'T_'.\nThe mapping between NGC and Elexon BMUs can be retrieved via reference data API endpoints.\n\nThis endpoint has an optimised JSON payload and is aimed at frequent requests for the data."
parameters:
- name: fuelType
in: query
description: The fuel type to query. Add each fuel type separately. If no fuel types are supplied, all fuel types will be returned.
schema:
type: array
items:
type: string
example:
- WIND
example:
- WIND
- name: publishDateTimeFrom
in: query
description: 'Start of the Publish Time range to query. If specified, PublishDateTimeTo must also be specified.
If both are omitted, latest published data is returned.'
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
description: 'End of the Publish Time range to query. If specified, PublishDateTimeFrom must also be specified.
If both are omitted, latest published data is returned.'
schema:
type: string
format: date-time
- name: bmUnit
in: query
description: 'The BM units to query. Add each unit separately. Either the Elexon ID or the National Grid ID can be used.
If no BM unit is supplied all BM units will be returned.'
schema:
type: array
items:
type: string
example:
- WTMSO-1
example:
- WTMSO-1
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByBmUnitDaily'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByBmUnitDaily'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByBmUnitDaily'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/UOU2T3YW:
get:
tags:
- BMRS Datasets
summary: 2 to 156 weeks ahead generation availability aggregated by Balancing Mechanism Units (UOU2T3YW)
description: "This endpoint forward view of availability (also referred to as Output Usable\ndata under the Grid Code) for generation and interconnector capacity, accounting for planned\noutages covering availability data from 2 weeks ahead to 156 weeks ahead; it is aggregated by\nBalancing Mechanism Units (BMUs).\n \nIn the context of this report, BMUs can be considered as generating units.\nElexon BMUs differs from NGC BMUs by including a prefix e.g. 'T_'.\nThe mapping between NGC and Elexon BMUs can be retrieved via reference data API endpoints.\n \nThis endpoint is subject to a limit of 100 requests per minute.\nAny requests made beyond this limit may result in a 429 error (\"Too Many Requests\")"
parameters:
- name: fuelType
in: query
description: The fuel type to query. Add each fuel type separately. If no fuel types are supplied, all fuel types will be returned.
schema:
type: array
items:
type: string
example:
- CCGT
example:
- CCGT
- name: publishDateTimeFrom
in: query
description: 'Start of the Publish Time range to query. If specified, PublishDateTimeTo must also be specified.
If both are omitted, latest published data is returned.'
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
description: 'End of the Publish Time range to query. If specified, PublishDateTimeFrom must also be specified.
If both are omitted, latest published data is returned.'
schema:
type: string
format: date-time
- name: bmUnit
in: query
description: 'The BM units to query. Add each unit separately. Either the Elexon ID or the National Grid ID can be used.
If no BM unit is supplied all BM units will be returned.'
schema:
type: array
items:
type: string
example:
- T_CARR-1
example:
- T_CARR-1
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByBmUnitWeekly'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByBmUnitWeekly'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByBmUnitWeekly'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByBmUnitWeekly'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByBmUnitWeekly'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByBmUnitWeekly'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/UOU2T3YW/stream:
get:
tags:
- BMRS Datasets
summary: 2 to 156 weeks ahead generation availability aggregated by Balancing Mechanism Units (UOU2T3YW) stream
description: "This endpoint forward view of availability (also referred to as Output Usable\ndata under the Grid Code) for generation and interconnector capacity, accounting for planned\noutages covering availability data from 2 weeks ahead to 156 weeks ahead; it is aggregated by\nBalancing Mechanism Units (BMUs).\n \nIn the context of this report, BMUs can be considered as generating units.\nElexon BMUs differs from NGC BMUs by including a prefix e.g. 'T_'.\nThe mapping between NGC and Elexon BMUs can be retrieved via reference data API endpoints.\n\nThis endpoint has an optimised JSON payload and is aimed at frequent requests for the data."
parameters:
- name: fuelType
in: query
description: The fuel type to query. Add each fuel type separately. If no fuel types are supplied, all fuel types will be returned.
schema:
type: array
items:
type: string
example:
- CCGT
example:
- CCGT
- name: publishDateTimeFrom
in: query
description: 'Start of the Publish Time range to query. If specified, PublishDateTimeTo must also be specified.
If both are omitted, latest published data is returned.'
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
description: 'End of the Publish Time range to query. If specified, PublishDateTimeFrom must also be specified.
If both are omitted, latest published data is returned.'
schema:
type: string
format: date-time
- name: bmUnit
in: query
description: 'The BM units to query. Add each unit separately. Either the Elexon ID or the National Grid ID can be used.
If no BM unit is supplied all BM units will be returned.'
schema:
type: array
items:
type: string
example:
- T_CARR-1
example:
- T_CARR-1
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByBmUnitWeekly'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByBmUnitWeekly'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByBmUnitWeekly'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/FOU2T14D:
get:
tags:
- BMRS Datasets
summary: 2 to 14 days ahead generation availability aggregated by fuel type (FOU2T14D)
description: "This endpoint provides a forward view of availability (also referred to as Output Usable data\nunder the Grid Code) for generation and interconnector capacity, accounting for planned outages\ncovering 2 days ahead to 14 days ahead; it is aggregated by Fuel Types categories.\n \nDate parameter must be provided in the exact format yyyy-MM-dd."
parameters:
- name: fuelType
in: query
schema:
type: array
items:
type: string
- name: publishDate
in: query
description: The publish date for filtering. This must be in the format yyyy-MM-dd.
schema:
type: string
format: date
example: '2022-09-20'
example: '2022-09-20'
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
- name: biddingZone
in: query
schema:
type: array
items:
type: string
- name: interconnector
in: query
schema:
type: boolean
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByFuelTypeDaily'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByFuelTypeDaily'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByFuelTypeDaily'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByFuelTypeDaily'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByFuelTypeDaily'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByFuelTypeDaily'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/FOU2T3YW:
get:
tags:
- BMRS Datasets
summary: 2 to 156 weeks ahead generation availability aggregated by fuel type (FOU2T3YW)
description: "This endpoint provides a forward view of availability (also referred to as Output Usable data\nunder the Grid Code) for generation and interconnector capacity, accounting for planned outages\ncovering availability data from 2 weeks ahead to 156 weeks ahead;\nit is aggregated by Fuel Types categories.\n \nDate parameter must be provided in the exact format yyyy-MM-dd."
parameters:
- name: fuelType
in: query
schema:
type: array
items:
type: string
- name: publishDate
in: query
description: The publish date for filtering. This must be in the format yyyy-MM-dd.
schema:
type: string
format: date
example: '2022-09-20'
example: '2022-09-20'
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
- name: week
in: query
schema:
type: array
items:
type: integer
format: int32
- name: year
in: query
schema:
type: array
items:
type: integer
format: int32
- name: biddingZone
in: query
schema:
type: array
items:
type: string
- name: interconnector
in: query
schema:
type: boolean
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByFuelTypeWeekly'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByFuelTypeWeekly'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByFuelTypeWeekly'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByFuelTypeWeekly'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByFuelTypeWeekly'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByFuelTypeWeekly'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/NOU2T14D:
get:
tags:
- BMRS Datasets
summary: 2 to 14 days ahead generation availability aggregated data (NOU2T14D)
description: "This endpoint provides a forward view of availability (also referred to as Output Usable data\nunder the Grid Code) for generation and interconnector capacity, accounting for planned outages\ncovering 2 days ahead to 14 days ahead. The data is aggregated at national level.\n \nDate parameter must be provided in the exact format yyyy-MM-dd."
parameters:
- name: publishDate
in: query
description: The publish date for filtering. This must be in the format yyyy-MM-dd.
schema:
type: string
format: date
example: '2022-09-20'
example: '2022-09-20'
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityDaily'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityDaily'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityDaily'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityDaily'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityDaily'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityDaily'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/NOU2T3YW:
get:
tags:
- BMRS Datasets
summary: 2 to 156 weeks ahead generation availability aggregated data (NOU2T3YW)
description: "This endpoint provides a forward view of availability (also referred to as Output Usable data\nunder the Grid Code) for generation and interconnector capacity, accounting for planned outages\ncovering availability data from 2 weeks ahead to 156 weeks ahead.\nThe data is an aggregation of all Fuel Type categories at national level.\n \nDate parameter must be provided in the exact format yyyy-MM-dd."
parameters:
- name: publishDate
in: query
description: The publish date for filtering. This must be in the format yyyy-MM-dd.
schema:
type: string
format: date
example: '2022-09-20'
example: '2022-09-20'
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
- name: week
in: query
schema:
type: array
items:
type: integer
format: int32
- name: year
in: query
schema:
type: array
items:
type: integer
format: int32
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityWeekly'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityWeekly'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityWeekly'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityWeekly'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityWeekly'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityWeekly'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/TEMP:
get:
tags:
- BMRS Datasets
summary: Temperature data (TEMP)
description: 'This endpoint provides the average degree celsius value measured at midday deemed to be
representative of the temperature for Great Britain. Data is gathered from 6 weather stations.
Default output will be the last 31 days. Values are received from 5pm each day.'
parameters:
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.TemperatureData'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.TemperatureData'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.TemperatureData'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.TemperatureData'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.TemperatureData'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.TemperatureData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/INDGEN:
get:
tags:
- BMRS Datasets
summary: Day and day-ahead indicated generation (INDGEN)
description: 'This endpoint provides the indicated generation received from NGESO. Data is received daily, by
midday. Expressed as an average MW value for each Settlement period. The indicated generation
forecast for each period is the sum of all the PNs submitted for BM Units which are forecast to
be exporting energy, presented as a single average MW value for the settlement period.
This API endpoint provides a maximum data output range of 1 day.'
parameters:
- name: boundary
in: query
schema:
type: string
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
- 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.DatasetResponse-1_Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedGeneration'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedGeneration'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedGeneration'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedGeneration'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedGeneration'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedGeneration'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/INDGEN/stream:
get:
tags:
- BMRS Datasets
summary: Day and day-ahead indicated generation (INDGEN) stream
description: 'This endpoint provides the indicated generation received from NGESO. Data is received daily, by
midday. Expressed as an average MW value for each settlement period. The indicated generation
forecast for each period is the sum of all the PNs submitted for BM Units which are forecast to
be exporting energy, presented as a single average MW value for the settlement period.
This endpoint has an optimised JSON payload and is aimed at frequent requests for the data.'
parameters:
- name: boundary
in: query
schema:
type: string
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedGeneration'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedGeneration'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedGeneration'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/INDDEM:
get:
tags:
- BMRS Datasets
summary: Day and day-ahead indicated demand (INDDEM)
description: "This endpoint provides the indicated demand forecast for the current day and day-ahead received\nfrom NGESO. The forecast is updated every half hour. The forecast for each period is the sum of\nall the PNs submitted for BM Units which are forecast to be importing energy. Data is presented\nan average MW for the settlement period.\n \nThis API endpoint provides a maximum data output range of 1 day."
parameters:
- name: boundary
in: query
schema:
type: string
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
- 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.DatasetResponse-1_Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedDemand'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedDemand'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedDemand'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedDemand'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedDemand'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedDemand'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/INDDEM/stream:
get:
tags:
- BMRS Datasets
summary: Day and day-ahead indicated demand (INDDEM) stream
description: 'This endpoint provides the indicated demand forecast for the current day and day-ahead received
from NGESO. The forecast is updated every half hour. The forecast for each period is the sum of
all the PNs submitted for BM Units which are forecast to be importing energy. Data is presented
an average MW for the settlement period.
This endpoint has an optimised JSON payload and is aimed at frequent requests for the data.'
parameters:
- name: boundary
in: query
schema:
type: string
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedDemand'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedDemand'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedDemand'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/MELNGC:
get:
tags:
- BMRS Datasets
summary: Day and day-ahead indicated margin (MELNGC)
description: "This endpoint provides the indicated margin. Data is received every half an hour from NGESO.\nExpressed as an average MW value for each settlement period. The indicated margin forecast for\neach settlement period is the difference between the sum of the MELs submitted for that period,\nand the National Demand forecast made by the System Operator. The greater the value, the higher\nthe margin between available generation capacity and forecast demand - that is to say, the more\nspare capacity there is forecast to be in the system.\n \nThis API endpoint provides a maximum data output range of 1 day."
parameters:
- name: boundary
in: query
schema:
type: string
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
- 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.DatasetResponse-1_Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedMargin'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedMargin'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedMargin'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedMargin'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedMargin'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedMargin'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/MELNGC/stream:
get:
tags:
- BMRS Datasets
summary: Day and day-ahead indicated margin (MELNGC) stream
description: 'This endpoint provides the indicated margin. Data is received every half an hour from NGESO.
Expressed as an average MW value for each settlement period. The indicated margin forecast for
each settlement period is the difference between the sum of the MELs submitted for that period,
and the National Demand forecast made by the System Operator. The greater the value, the higher
the margin between available generation capacity and forecast demand - that is to say, the more
spare capacity there is forecast to be in the system.
This endpoint has an optimised JSON payload and is aimed at frequent requests for the data.'
parameters:
- name: boundary
in: query
schema:
type: string
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedMargin'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedMargin'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedMargin'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/IMBALNGC:
get:
tags:
- BMRS Datasets
summary: Day and day-ahead indicated imbalance (IMBALNGC)
description: "This endpoint provides the indicated imbalance. Data is received by daily by midday from NGESO.\nExpressed as an average MW value for each settlement period. The indicated imbalance forecast for\neach period is the difference between the sum of the PNs submitted for generation BM Units (i.e.\nthe indicated generation), and the Transmission System Demand forecast made by the System Operator.\n \nThis API endpoint provides a maximum data output range of 1 day."
parameters:
- name: boundary
in: query
schema:
type: string
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
- 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.DatasetResponse-1_Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedImbalance'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedImbalance'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedImbalance'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedImbalance'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedImbalance'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedImbalance'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/IMBALNGC/stream:
get:
tags:
- BMRS Datasets
summary: Day and day-ahead indicated imbalance (IMBALNGC) stream
description: 'This endpoint provides the indicated imbalance. Data is received by daily by midday from NGESO.
Expressed as an average MW value for each settlement period. The indicated imbalance forecast for
each period is the difference between the sum of the PNs submitted for generation BM Units (i.e.
the indicated generation), and the National Demand forecast made by the System Operator.
This endpoint has an optimised JSON payload and is aimed at frequent requests for the data.'
parameters:
- name: boundary
in: query
schema:
type: string
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedImbalance'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedImbalance'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedImbalance'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/NDF:
get:
tags:
- BMRS Datasets
summary: Day and day-ahead National Demand forecast (NDF)
description: "This endpoint provides the National Demand forecast received from NGESO. Data is available\ndaily and will show values for the day ahead. Expressed as an average MW\nvalue for each settlement period. The forecast is based on historically metered generation\noutput for Great Britain. This value INCLUDES transmission losses, but EXCLUDES interconnector\nflows and demand from station transformers and pumped storage units.\n \nThis API endpoint provides a maximum data output range of 1 day.\n \nSpecific publish time filters may be supplied, otherwise this will retrieve the latest published forecast."
parameters:
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
- 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.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastNationalDayAhead'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastNationalDayAhead'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastNationalDayAhead'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastNationalDayAhead'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastNationalDayAhead'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastNationalDayAhead'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/NDF/stream:
get:
tags:
- BMRS Datasets
summary: Day and day-ahead National Demand forecast (NDF) stream
description: "This endpoint provides the National Demand forecast received from NGESO. Data is available\ndaily and will show values for the day ahead. Expressed as an average MW\nvalue for each settlement period. The forecast is based on historically metered generation\noutput for Great Britain. This value INCLUDES transmission losses, but EXCLUDES interconnector\nflows and demand from station transformers and pumped storage units.\n \nSpecific publish time filters may be supplied, otherwise this will retrieve the latest published forecast.\n\nThis endpoint has an optimised JSON payload and is aimed at frequent requests for the data."
parameters:
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastNationalDayAhead'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastNationalDayAhead'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastNationalDayAhead'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/TSDF:
get:
tags:
- BMRS Datasets
summary: Day and day-ahead Transmission System Demand forecast (TSDF)
description: "This endpoint provides the Transmission System Demand forecast.\nData is received daily from NGESO and will show values for the day ahead.\nExpressed as an average MW value for each settlement period.\nThe Transmission System Demand forecast is based on historically metered generation output for Great Britain.\nThis value INCLUDES interconnector flows and demand from station transformers and pumped storage units.\n\nSpecific publish time filters may be supplied, otherwise this will retrieve the latest published forecast.\n \nThis API endpoint provides a maximum data output range of 1 day."
parameters:
- name: boundary
in: query
schema:
type: string
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
- 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.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastTransmissionDayAhead'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastTransmissionDayAhead'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastTransmissionDayAhead'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastTransmissionDayAhead'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastTransmissionDayAhead'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastTransmissionDayAhead'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/TSDF/stream:
get:
tags:
- BMRS Datasets
summary: Day and day-ahead Transmission System Demand forecast (TSDF) stream
description: 'This endpoint provides the Transmission System Demand forecast .
Data is received daily from NGESO and will show values for the day ahead.
Expressed as an average MW value for each settlement period.
The Transmission System Demand forecast is based on historically metered generation output for Great Britain.
This value INCLUDES interconnector flows and demand from station transformers and pumped storage units.
Specific publish time filters may be supplied, otherwise this will retrieve the latest published forecast.
This endpoint has an optimised JSON payload and is aimed at frequent requests for the data.'
parameters:
- name: boundary
in: query
schema:
type: string
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastTransmissionDayAhead'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastTransmissionDayAhead'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastTransmissionDayAhead'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/WINDFOR:
get:
tags:
- BMRS Datasets
summary: Wind generation forecast (WINDFOR)
description: 'This endpoint provides wind generation forecast data.
Specific publish time filters may be supplied, otherwise this will retrieve the latest published forecast.'
parameters:
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.WindGenerationForecast'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.WindGenerationForecast'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.WindGenerationForecast'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.WindGenerationForecast'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.WindGenerationForecast'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.WindGenerationForecast'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/WINDFOR/stream:
get:
tags:
- BMRS Datasets
summary: Wind generation forecast (WINDFOR) stream
description: 'This endpoint provides wind generation forecast data.
Specific publish time filters may be supplied, otherwise this will retrieve the latest published forecast.
This endpoint has an optimised JSON payload and is aimed at frequent requests for the data.'
parameters:
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Generation.DatasetRows.WindGenerationForecast'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Generation.DatasetRows.WindGenerationForecast'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Generation.DatasetRows.WindGenerationForecast'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/INDO:
get:
tags:
- BMRS Datasets
summary: Initial National Demand outturn (INDO)
description: "The endpoint provides data showing the initial National Demand outturn.\nData is updated at 15 min intervals containing the initial demand expressed in MW.\n \nSpecific publish time filters may be supplied, otherwise this will retrieve the latest published data."
parameters:
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
- 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.DatasetResponse-1_Insights.Api.Models.Responses.DemandOutturn.DatasetRows.DemandOutturnNational'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandOutturn.DatasetRows.DemandOutturnNational'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandOutturn.DatasetRows.DemandOutturnNational'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandOutturn.DatasetRows.DemandOutturnNational'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandOutturn.DatasetRows.DemandOutturnNational'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandOutturn.DatasetRows.DemandOutturnNational'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/INDOD:
get:
tags:
- BMRS Datasets
summary: Initial National Demand outturn daily (INDOD)
description: 'This endpoint provides initial National Demand outturn daily data. The total daily energy volume is the total
demand volume for the previous day expressed on an initial National Demand outturn (INDO) basis, i.e. excluding
station transformer, pumping and interconnector export demand. It is calculated from summing the half hourly
INDO demands (divided by two to convert to MWh).
This API endpoint has a maximum range of 2 years (731 days).'
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: '2023-08-26T01:00:00Z'
example: '2023-08-26T01:00:00Z'
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: '2023-08-27T01:00:00Z'
example: '2023-08-27T01:00:00Z'
- 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.DatasetResponse-1_Insights.Api.Models.Responses.DemandOutturn.DatasetRows.IndodDatasetRow'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandOutturn.DatasetRows.IndodDatasetRow'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandOutturn.DatasetRows.IndodDatasetRow'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandOutturn.DatasetRows.IndodDatasetRow'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandOutturn.DatasetRows.IndodDatasetRow'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandOutturn.DatasetRows.IndodDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/INDOD/stream:
get:
tags:
- BMRS Datasets
summary: Initial National Demand outturn daily (INDOD) stream
description: 'This endpoint provides initial National Demand outturn daily data. The total daily energy volume is the total
demand volume for the previous day expressed on an initial National Demand outturn (INDO) basis, i.e. excluding
station transformer, pumping and interconnector export demand. It is calculated from summing the half hourly
INDO demands (divided by two to convert to MWh).
This endpoint has an optimised JSON payload and is aimed at frequent requests for the data.'
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: '2023-08-26T01:00:00Z'
example: '2023-08-26T01:00:00Z'
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: '2023-08-27T01:00:00Z'
example: '2023-08-27T01:00:00Z'
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DemandOutturn.DatasetRows.IndodDatasetRow'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DemandOutturn.DatasetRows.IndodDatasetRow'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DemandOutturn.DatasetRows.IndodDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/ITSDO:
get:
tags:
- BMRS Datasets
summary: Initial Transmission System Demand outturn (ITSDO)
description: "The endpoint provides data showing the initial Transmission System Demand outturn.\nData is updated at 15 min intervals containing the initial demand expressed in MW.\n \nSpecific publish time filters may be supplied, otherwise this will retrieve the latest published forecast."
parameters:
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
- 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.DatasetResponse-1_Insights.Api.Models.Responses.DemandOutturn.DatasetRows.DemandOutturnTransmission'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandOutturn.DatasetRows.DemandOutturnTransmission'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandOutturn.DatasetRows.DemandOutturnTransmission'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandOutturn.DatasetRows.DemandOutturnTransmission'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandOutturn.DatasetRows.DemandOutturnTransmission'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandOutturn.DatasetRows.DemandOutturnTransmission'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/NDFD:
get:
tags:
- BMRS Datasets
summary: 2-14 days ahead National Demand and surplus forecast (NDFD)
description: 'This endpoint provides the National Demand forecast received from NGESO.
Data is available daily and will show values for the 2 to 14 days ahead.
Expressed as an average MW value for each Settlement period. The forecast is based on historically metered generation output for Great Britain.
This value INCLUDES transmission losses, but EXCLUDES interconnector flows and demand from station.
This API endpoint provides a maximum data output range of 92 days.
Specific publish time filters may be supplied, otherwise this will retrieve the latest published forecast.'
parameters:
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
- 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.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastNationalDaily'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastNationalDaily'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastNationalDaily'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastNationalDaily'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastNationalDaily'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastNationalDaily'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/NDFD/stream:
get:
tags:
- BMRS Datasets
summary: 2-14 days ahead National Demand and surplus forecast (NDFD) stream
description: 'This endpoint provides the National Demand forecast received from NGESO.
Data is available daily and will show values for the 2 to 14 days ahead.
Expressed as an average MW value for each Settlement period. The forecast is based on historically metered generation output for Great Britain.
This value INCLUDES transmission losses, but EXCLUDES Interconnector flows and demand from station
Specific publish time filters may be supplied, otherwise this will retrieve the latest published forecast.
This endpoint has an optimised JSON payload and is aimed at frequent requests for the data.'
parameters:
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastNationalDaily'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastNationalDaily'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastNationalDaily'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/TSDFD:
get:
tags:
- BMRS Datasets
summary: 2-14 days ahead Transmission System Demand and surplus forecast (TSDFD)
description: "This endpoint provides the Transmission System forecast. Data is available daily and will show values for the 2 to 14 days ahead.\nExpressed as an average MW value for each settlement period. The Transmission System Demand forecast is based on historically metered generation output for Great Britain.\nThis value INCLUDES interconnector flows and demand from station transformers and pumped storage units.\n \nSpecific publish time filters may be supplied, otherwise this will retrieve the latest published forecast.\n \nThis API endpoint provides a maximum data output range of 92 days."
parameters:
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
- 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.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastTransmissionDaily'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastTransmissionDaily'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastTransmissionDaily'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastTransmissionDaily'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastTransmissionDaily'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastTransmissionDaily'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/TSDFD/stream:
get:
tags:
- BMRS Datasets
summary: 2-14 days ahead Transmission System Demand and surplus forecast (TSDFD) stream
description: "This endpoint provides the Transmission System Demand forecast. Data is available daily and will show values for the 2 to 14 days ahead.\nExpressed as an average MW value for each settlement period. The Transmission System Demand forecast is based on historically metered generation output for Great Britain.\nThis value INCLUDES interconnector flows and demand from station transformers and pumped storage units.\n \nSpecific publish time filters may be supplied, otherwise this will retrieve the latest published forecast.\n \nThis endpoint has an optimised JSON payload and is aimed at frequent requests for the data."
parameters:
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastTransmissionDaily'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastTransmissionDaily'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastTransmissionDaily'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/NDFW:
get:
tags:
- BMRS Datasets
summary: 2-52 weeks ahead National Demand and surplus forecast (NDFW)
description: 'This endpoint provides the National Demand forecast received from NGESO.
Data is available from 4pm each Thursday and will show values for the 2 to 52 weeks ahead.
Expressed as an average MW value for each week. The forecast is based on historically metered generation output for Great Britain.
This value INCLUDES transmission losses, but EXCLUDES interconnector flows and demand from station.
This API endpoint provides a maximum data output range of 366 days.
Specific publish time filters may be supplied, otherwise this will retrieve the latest published forecast.'
parameters:
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
- 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.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastNationalWeekly'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastNationalWeekly'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastNationalWeekly'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastNationalWeekly'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastNationalWeekly'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastNationalWeekly'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/NDFW/stream:
get:
tags:
- BMRS Datasets
summary: 2-52 weeks ahead National Demand and surplus forecast (NDFW) stream
description: 'This endpoint provides the National Demand forecast received from NGESO.
Data is available from 4pm each Thursday and will show values for the 2 to 52 weeks ahead.
Expressed as an average MW value for each week. The forecast is based on historically metered generation output for Great Britain.
This value INCLUDES transmission losses, but EXCLUDES interconnector flows and demand from station.
Specific publish time filters may be supplied, otherwise this will retrieve the latest published forecast.
This endpoint has an optimised JSON payload and is aimed at frequent requests for the data.'
parameters:
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastNationalWeekly'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastNationalWeekly'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastNationalWeekly'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/TSDFW:
get:
tags:
- BMRS Datasets
summary: 2-52 weeks ahead Transmission System Demand and surplus forecast (TSDFW)
description: 'This endpoint provides the Transmission System Demand forecast received from NGESO.
Data is available from 4pm each Thursday and will show values for the 2 to 52 weeks ahead.
Expressed as an average MW value for each week. The forecast is based on historically metered generation output for Great Britain.
This value INCLUDES transmission losses, but EXCLUDES interconnector flows and demand from station.
This API will provide a maximum data output range of 366 days.
Specific publish time filters may be supplied, otherwise this will retrieve the latest published forecast.'
parameters:
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
- 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.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastTransmissionWeekly'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastTransmissionWeekly'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastTransmissionWeekly'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastTransmissionWeekly'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastTransmissionWeekly'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastTransmissionWeekly'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/TSDFW/stream:
get:
tags:
- BMRS Datasets
summary: 2-52 weeks ahead Transmission System Demand and surplus forecast (TSDFW) stream
description: 'This endpoint provides the Transmission System Demand forecast received from NGESO.
Data is available from 4pm each Thursday and will show values for the 2 to 52 weeks ahead.
Expressed as an average MW value for each week. The forecast is based on historically metered generation output for Great Britain.
This value INCLUDES transmission losses, but EXCLUDES interconnector flows and demand from station.
Specific publish time filters may be supplied, otherwise this will retrieve the latest published forecast.
This endpoint has an optimised JSON payload and is aimed at frequent requests for the data.'
parameters:
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastTransmissionWeekly'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastTransmissionWeekly'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastTransmissionWeekly'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/FREQ:
get:
tags:
- BMRS Datasets
summary: System frequency (FREQ)
description: "The endpoint provides data that has been received every 2 minutes the transmission system frequency, expressed as a hertz value for one or more spot times within that 2 minute period.\nThe default output will be the latest published data.\n \nA maximum limit of 24 hours is applied to this endpoint to limit response size. Use the streaming version\nfor larger response sizes."
parameters:
- name: measurementDateTimeFrom
in: query
schema:
type: string
format: date-time
- name: measurementDateTimeTo
in: query
schema:
type: string
format: date-time
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.SystemFrequency'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.SystemFrequency'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.SystemFrequency'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.SystemFrequency'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.SystemFrequency'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.SystemFrequency'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/FREQ/stream:
get:
tags:
- BMRS Datasets
summary: System frequency (FREQ) stream
description: 'The endpoint provides data that has been received every 2 minutes the transmission system frequency, expressed as a hertz value for one or more spot times within that 2 minute period.
The default output will be the latest published data.
This endpoint has an optimised JSON payload and is aimed at frequent requests for the data.'
parameters:
- name: measurementDateTimeFrom
in: query
schema:
type: string
format: date-time
- name: measurementDateTimeTo
in: query
schema:
type: string
format: date-time
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Misc.DatasetRows.SystemFrequency'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Misc.DatasetRows.SystemFrequency'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Misc.DatasetRows.SystemFrequency'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/OCNMFD:
get:
tags:
- BMRS Datasets
summary: 2-14 days ahead demand surplus forecast (OCNMFD)
description: "The demand surplus forecast data is received hourly from NGESO.\nIt shows the daily peak half hour MW value of generating plant demand surplus for each day for the 2 to 14 days ahead.\n\nThis API endpoint provides a maximum data output range of 7 days.\n \nSpecific publish time filters may be supplied, otherwise this will retrieve the latest published forecast."
parameters:
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
- 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.DatasetResponse-1_Insights.Api.Models.Responses.ForecastSurplus.DatasetRows.ForecastSurplusDaily'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.ForecastSurplus.DatasetRows.ForecastSurplusDaily'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.ForecastSurplus.DatasetRows.ForecastSurplusDaily'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.ForecastSurplus.DatasetRows.ForecastSurplusDaily'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.ForecastSurplus.DatasetRows.ForecastSurplusDaily'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.ForecastSurplus.DatasetRows.ForecastSurplusDaily'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/OCNMFD/stream:
get:
tags:
- BMRS Datasets
summary: 2-14 days ahead demand surplus forecast (OCNMFD) stream
description: 'The demand surplus forecast data is received hourly from NGESO.
It shows the daily peak half hour MW value of generating plant demand surplus for each day for the 2 to 14 days ahead.
Specific publish time filters may be supplied, otherwise this will retrieve the latest published forecast.
This endpoint has an optimised JSON payload and is aimed at frequent requests for the data.'
parameters:
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.ForecastSurplus.DatasetRows.ForecastSurplusDaily'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.ForecastSurplus.DatasetRows.ForecastSurplusDaily'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.ForecastSurplus.DatasetRows.ForecastSurplusDaily'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/OCNMFD2:
get:
tags:
- BMRS Datasets
summary: 2-14 days ahead demand margin forecast (OCNMFD2)
description: "The demand margin forecast is received hourly from NGESO.\nIt shows the daily peak half hour MW value of generating plant demand margin for each day for the 2 to 14 days ahead.\n\nThis API endpoint provides a maximum data output range of 7 days.\n \nSpecific publish time filters may be supplied, otherwise this will retrieve the latest published forecast."
parameters:
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
- 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.DatasetResponse-1_Insights.Api.Models.Responses.ForecastMargin.DatasetRows.ForecastMarginDaily'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.ForecastMargin.DatasetRows.ForecastMarginDaily'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.ForecastMargin.DatasetRows.ForecastMarginDaily'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.ForecastMargin.DatasetRows.ForecastMarginDaily'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.ForecastMargin.DatasetRows.ForecastMarginDaily'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.ForecastMargin.DatasetRows.ForecastMarginDaily'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/OCNMFD2/stream:
get:
tags:
- BMRS Datasets
summary: 2-14 days ahead demand margin forecast (OCNMFD2) stream
description: 'The demand margin forecast is received hourly from NGESO.
It shows the daily peak half hour MW value of generating plant demand margin for each day for the 2 to 14 days ahead.
Specific publish time filters may be supplied, otherwise this will retrieve the latest published forecast.
This endpoint has an optimised JSON payload and is aimed at frequent requests for the data.'
parameters:
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.ForecastMargin.DatasetRows.ForecastMarginDaily'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.ForecastMargin.DatasetRows.ForecastMarginDaily'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.ForecastMargin.DatasetRows.ForecastMarginDaily'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/OCNMF3Y:
get:
tags:
- BMRS Datasets
summary: 2-156 weeks ahead demand surplus forecast (OCNMF3Y)
description: "The demand surplus forecast data is received hourly from NGESO.\nIt shows the weekly peak half hour MW value of generating plant demand surplus for each day for the 2-156 weeks ahead.\n\nThis API endpoint provides a maximum data output range of 7 days.\n \nSpecific publish time filters may be supplied, otherwise this will retrieve the latest published forecast."
parameters:
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
- 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.DatasetResponse-1_Insights.Api.Models.Responses.ForecastSurplus.DatasetRows.ForecastSurplusWeekly'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.ForecastSurplus.DatasetRows.ForecastSurplusWeekly'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.ForecastSurplus.DatasetRows.ForecastSurplusWeekly'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.ForecastSurplus.DatasetRows.ForecastSurplusWeekly'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.ForecastSurplus.DatasetRows.ForecastSurplusWeekly'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.ForecastSurplus.DatasetRows.ForecastSurplusWeekly'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/OCNMF3Y/stream:
get:
tags:
- BMRS Datasets
summary: 2-156 weeks ahead demand surplus forecast (OCNMF3Y) stream
description: 'The demand surplus forecast data is received hourly from NGESO.
It shows the weekly peak half hour MW value of generating plant demand surplus for each day for the 2-156 weeks ahead.
Specific publish time filters may be supplied, otherwise this will retrieve the latest published forecast.
This endpoint has an optimised JSON payload and is aimed at frequent requests for the data.'
parameters:
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.ForecastSurplus.DatasetRows.ForecastSurplusWeekly'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.ForecastSurplus.DatasetRows.ForecastSurplusWeekly'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.ForecastSurplus.DatasetRows.ForecastSurplusWeekly'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/OCNMF3Y2:
get:
tags:
- BMRS Datasets
summary: 2-156 weeks ahead demand margin forecast (OCNMF3Y2)
description: "The demand margin forecast is received hourly from NGESO.\nIt shows the weekly peak half hour MW value of generating plant demand margin for each day for the 2 to 156 weeks ahead.\n \nThis API endpoint has a maximum data output range of 7 days.\n\nSpecific publish time filters may be supplied, otherwise this will retrieve the latest published forecast."
parameters:
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
- 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.DatasetResponse-1_Insights.Api.Models.Responses.ForecastMargin.DatasetRows.ForecastMarginWeekly'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.ForecastMargin.DatasetRows.ForecastMarginWeekly'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.ForecastMargin.DatasetRows.ForecastMarginWeekly'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.ForecastMargin.DatasetRows.ForecastMarginWeekly'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.ForecastMargin.DatasetRows.ForecastMarginWeekly'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.ForecastMargin.DatasetRows.ForecastMarginWeekly'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/OCNMF3Y2/stream:
get:
tags:
- BMRS Datasets
summary: 2-156 weeks ahead demand margin forecast (OCNMF3Y2) stream
description: 'The demand margin forecast is received hourly from NGESO.
It shows the weekly peak half hour MW value of generating plant demand margin for each day for the 2 to 156 weeks ahead.
Specific publish time filters may be supplied, otherwise this will retrieve the latest published forecast.
This endpoint has an optimised JSON payload and is aimed at frequent requests for the data.'
parameters:
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.ForecastMargin.DatasetRows.ForecastMarginWeekly'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.ForecastMargin.DatasetRows.ForecastMarginWeekly'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.ForecastMargin.DatasetRows.ForecastMarginWeekly'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/metadata/latest:
get:
tags:
- BMRS Datasets
summary: Returns the time when each dataset was last updated
description: 'Depending on the dataset, this value may be taken from the timestamp on the source datafile, the
publishTime field on the dataset, or the latest available measurement time.'
parameters:
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Reference.DatasetMetadataLatestRow'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Reference.DatasetMetadataLatestRow'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Reference.DatasetMetadataLatestRow'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Reference.DatasetMetadataLatestRow'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Reference.DatasetMetadataLatestRow'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Reference.DatasetMetadataLatestRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/LOLPDRM:
get:
tags:
- BMRS Datasets
summary: Loss of load probability and de-rated margin (LOLPDRM)
description: "The loss of load probability and de-rated margin data is received half-hourly from NGESO.\n \nLoss of load probability (LoLP) is a measure of system reliability, calculated by NGESO for each settlement period,\nusing the methodology set out in the Loss of Load Probability Calculation Statement.\n \nDe-rated margin is a forecast of the excess supply on the system, which has been adjusted to take account of the likely availability of electricity generators."
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: 2023-03-06T07:00Z
example: 2023-03-06T07:00Z
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: 2023-03-06T12:00Z
example: 2023-03-06T12:00Z
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.LossOfLoadProbabilityDeratedMarginData'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.LossOfLoadProbabilityDeratedMarginData'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.LossOfLoadProbabilityDeratedMarginData'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.LossOfLoadProbabilityDeratedMarginData'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.LossOfLoadProbabilityDeratedMarginData'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.LossOfLoadProbabilityDeratedMarginData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/LOLPDRM/stream:
get:
tags:
- BMRS Datasets
summary: Loss of load probability and de-rated margin (LOLPDRM)
description: "The loss of load probability and de-rated margin data is received half-hourly from NGESO.\n \nLoss of load probability (LoLP) is a measure of system reliability, calculated by NGESO for each settlement period,\nusing the methodology set out in the Loss of Load Probability Calculation Statement.\n \nDe-rated margin is a forecast of the excess supply on the system, which has been adjusted to take account of the likely availability of electricity generators.\n\nThis endpoint has an optimised JSON payload and is aimed at frequent requests for the data."
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: 2023-03-06T07:00Z
example: 2023-03-06T07:00Z
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: 2023-03-06T12:00Z
example: 2023-03-06T12:00Z
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Misc.DatasetRows.LossOfLoadProbabilityDeratedMarginData'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Misc.DatasetRows.LossOfLoadProbabilityDeratedMarginData'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Misc.DatasetRows.LossOfLoadProbabilityDeratedMarginData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/CDN:
get:
tags:
- BMRS Datasets
summary: Credit default notices (CDN)
description: This endpoint provides CDN (Credit Default Notice) data received from ECVAA (Energy Contract Volume Aggregation Agent).
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: '2022-06-25T00:00:00Z'
example: '2022-06-25T00:00:00Z'
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: '2022-06-26T00:00:00Z'
example: '2022-06-26T00:00:00Z'
- name: bscPartyId
in: query
schema:
type: string
example: INVE
example: INVE
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.CreditDefaultNoticeDatasetResponse'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.CreditDefaultNoticeDatasetResponse'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.CreditDefaultNoticeDatasetResponse'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.CreditDefaultNoticeDatasetResponse'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.CreditDefaultNoticeDatasetResponse'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.CreditDefaultNoticeDatasetResponse'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/CDN/stream:
get:
tags:
- BMRS Datasets
summary: Credit default notices (CDN) stream
description: "This endpoint provides CDN (Credit Default Notice) data received from ECVAA (Energy Contract Volume Aggregation Agent).\n \nThis endpoint has an optimised JSON payload and is aimed at frequent requests for the data."
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: '2022-06-25T00:00:00Z'
example: '2022-06-25T00:00:00Z'
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: '2022-06-26T00:00:00Z'
example: '2022-06-26T00:00:00Z'
- name: bscPartyId
in: query
schema:
type: string
example: INVE
example: INVE
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.DatasetRows.CreditDefaultNoticeDatasetResponse'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.DatasetRows.CreditDefaultNoticeDatasetResponse'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.DatasetRows.CreditDefaultNoticeDatasetResponse'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/SYSWARN:
get:
tags:
- BMRS Datasets
summary: System warnings (SYSWARN)
description: This endpoint provides system warnings data
parameters:
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
example: 2023/06/01 07:00
example: 2023/06/01 07:00
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
example: 2023/06/30 10:00
example: 2023/06/30 10:00
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.SystemWarningsData'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.SystemWarningsData'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.SystemWarningsData'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.SystemWarningsData'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.SystemWarningsData'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.SystemWarningsData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/SYSWARN/stream:
get:
tags:
- BMRS Datasets
summary: System warnings (SYSWARN) stream
description: 'This endpoint provides system warnings data
This endpoint has an optimised JSON payload and is aimed at frequent requests for the data.'
parameters:
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
example: 2023/06/01 07:00
example: 2023/06/01 07:00
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
example: 2023/06/30 10:00
example: 2023/06/30 10:00
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Misc.DatasetRows.SystemWarningsData'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Misc.DatasetRows.SystemWarningsData'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Misc.DatasetRows.SystemWarningsData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/DCI:
get:
tags:
- BMRS Datasets
summary: Demand control instructions (DCI)
description: This endpoint provides demand control instruction data, filtered by publish time.
parameters:
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
example: 2021-04-30T00:00Z
example: 2021-04-30T00:00Z
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
example: 2021-05-30T20:00Z
example: 2021-05-30T20:00Z
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.DemandControlInstructionDatasetRow'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.DemandControlInstructionDatasetRow'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.DemandControlInstructionDatasetRow'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.DemandControlInstructionDatasetRow'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.DemandControlInstructionDatasetRow'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.DemandControlInstructionDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/DCI/stream:
get:
tags:
- BMRS Datasets
summary: Demand control instructions (DCI) stream
description: 'This endpoint provides demand control instruction data, filtered by publish time.
This endpoint has an optimised JSON payload and is aimed at frequent requests for the data.'
parameters:
- name: publishDateTimeFrom
in: query
schema:
type: string
format: date-time
example: 2021-04-30T00:00Z
example: 2021-04-30T00:00Z
- name: publishDateTimeTo
in: query
schema:
type: string
format: date-time
example: 2021-05-30T20:00Z
example: 2021-05-30T20:00Z
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Misc.DatasetRows.DemandControlInstructionDatasetRow'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Misc.DatasetRows.DemandControlInstructionDatasetRow'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Misc.DatasetRows.DemandControlInstructionDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/SOSO:
get:
tags:
- BMRS Datasets
summary: SO-SO prices (SOSO)
description: 'This endpoint provides system operator to system operator prices data, filtered by publish time.
This API endpoint has a maximum range of 24 hours.'
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: '2023-09-26T07:00:00Z'
example: '2023-09-26T07:00:00Z'
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: '2023-09-27T07:00:00Z'
example: '2023-09-27T07:00:00Z'
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.SoSoPricesDatasetRow'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.SoSoPricesDatasetRow'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.SoSoPricesDatasetRow'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.SoSoPricesDatasetRow'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.SoSoPricesDatasetRow'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.SoSoPricesDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/SOSO/stream:
get:
tags:
- BMRS Datasets
summary: SO-SO prices (SOSO) stream
description: 'This endpoint provides system operator to system operator prices data, filtered by publish time.
This endpoint has an optimised JSON payload and is aimed at frequent requests for the data.'
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: '2023-09-26T07:00:00Z'
example: '2023-09-26T07:00:00Z'
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: '2023-09-27T07:00:00Z'
example: '2023-09-27T07:00:00Z'
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Misc.DatasetRows.SoSoPricesDatasetRow'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Misc.DatasetRows.SoSoPricesDatasetRow'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Misc.DatasetRows.SoSoPricesDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/TUDM:
get:
tags:
- BMRS Datasets
summary: Trading unit data (S0491_TUDM)
description: This endpoint provides trading unit data for a settlement period filtered by trading unit name and type.
parameters:
- name: settlementDate
in: query
description: The settlement date to filter. This must be in the format yyyy-MM-dd.
required: true
schema:
type: string
format: date
example: '2023-10-05'
example: '2023-10-05'
- name: settlementPeriod
in: query
required: true
schema:
type: integer
format: int32
example: 10
example: 10
- name: tradingUnitName
in: query
schema:
type: array
items:
type: string
example:
- DEFAULT__A
example:
- DEFAULT__A
- name: tradingUnitType
in: query
schema:
enum:
- Base
- Sole
- Others
type: string
example: Base
example: Base
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.TudmDatasetRow'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.TudmDatasetRow'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.TudmDatasetRow'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.TudmDatasetRow'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.TudmDatasetRow'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.TudmDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/TUDM/stream:
get:
tags:
- BMRS Datasets
summary: Trading unit data (S0491_TUDM) stream
description: 'This endpoint provides trading unit data filtered by settlement period, trading unit name and type.
This endpoint has an optimised JSON payload and is aimed at frequent requests for the data.'
parameters:
- name: settlementDateFrom
in: query
description: The settlement date to filter from. This must be in the format yyyy-MM-dd.
required: true
schema:
type: string
format: date
example: '2023-10-05'
example: '2023-10-05'
- name: settlementPeriodFrom
in: query
required: true
schema:
type: integer
format: int32
example: 10
example: 10
- name: settlementDateTo
in: query
description: The settlement date to filter to. This must be in the format yyyy-MM-dd.
required: true
schema:
type: string
format: date
example: '2023-10-05'
example: '2023-10-05'
- name: settlementPeriodTo
in: query
required: true
schema:
type: integer
format: int32
example: 11
example: 11
- name: tradingUnitName
in: query
schema:
type: array
items:
type: string
example:
- DEFAULT__A
example:
- DEFAULT__A
- name: tradingUnitType
in: query
schema:
enum:
- Base
- Sole
- Others
type: string
example: Base
example: Base
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Misc.DatasetRows.TudmDatasetRow'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Misc.DatasetRows.TudmDatasetRow'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Misc.DatasetRows.TudmDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/RZDF:
get:
tags:
- BMRS Datasets
summary: Restoration Region Demand Forecast (RZDF)
description: 'This endpoint provides the forecasted peak demand values (60% and 100%) for each restoration region with filtering by submission time, region, and GSP Group ID (when received by NESO).
This API endpoint supports up to 12 months range per request.'
parameters:
- name: submissionDateTimeFrom
in: query
description: The submission date and time to filter from. This should be in the format yyyy-MM-dd HH:mm:ssZ.
required: true
schema:
type: string
format: date-time
example: '2025-06-25 00:00:00Z'
example: '2025-06-25 00:00:00Z'
- name: submissionDateTimeTo
in: query
description: The submission date and time to filter to. This should be in the format yyyy-MM-dd HH:mm:ssZ.
required: true
schema:
type: string
format: date-time
example: '2025-07-05 00:00:00Z'
example: '2025-07-05 00:00:00Z'
- name: region
in: query
description: The region to filter by.
schema:
enum:
- North Scotland
- South Scotland
- North West
- North East
- Midlands
- South West
- South East
type: string
- name: gspGroupId
in: query
description: The GSP Group ID to filter by.
schema:
type: string
- 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.DatasetResponse-1_Insights.Api.Models.Responses.RestorationZone.RestorationZoneDemandForecastDatasetRow'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.RestorationZone.RestorationZoneDemandForecastDatasetRow'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.RestorationZone.RestorationZoneDemandForecastDatasetRow'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.RestorationZone.RestorationZoneDemandForecastDatasetRow'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.RestorationZone.RestorationZoneDemandForecastDatasetRow'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.RestorationZone.RestorationZoneDemandForecastDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/RZDF/stream:
get:
tags:
- BMRS Datasets
summary: Restoration Region Demand Forecast (RZDF) stream
description: 'This endpoint provides the forecasted peak demand values (60% and 100%) for each restoration region with filtering by submission time, region, and GSP Group ID (when received by NESO).
This endpoint has an optimised JSON payload and is aimed at frequent requests for the data.'
parameters:
- name: submissionDateTimeFrom
in: query
description: The submission date and time to filter from. This should be in the format yyyy-MM-dd HH:mm:ssZ.
required: true
schema:
type: string
format: date-time
example: '2025-06-25 00:00:00Z'
example: '2025-06-25 00:00:00Z'
- name: submissionDateTimeTo
in: query
description: The submission date and time to filter to. This should be in the format yyyy-MM-dd HH:mm:ssZ.
required: true
schema:
type: string
format: date-time
example: '2025-07-05 00:00:00Z'
example: '2025-07-05 00:00:00Z'
- name: region
in: query
description: The region to filter by.
schema:
enum:
- North Scotland
- South Scotland
- North West
- North East
- Midlands
- South West
- South East
type: string
- name: gspGroupId
in: query
description: The GSP Group ID to filter by.
schema:
type: string
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.RestorationZone.RestorationZoneDemandForecastDatasetRow'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.RestorationZone.RestorationZoneDemandForecastDatasetRow'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.RestorationZone.RestorationZoneDemandForecastDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/RZDR:
get:
tags:
- BMRS Datasets
summary: Restoration Region Demand Restored (RZDR)
description: 'This endpoint provides the restored demand value for each restoration region with filtering by submission time, region, and GSP Group ID (when received by NESO).
This API endpoint supports up to 12 months range per request.'
parameters:
- name: submissionDateTimeFrom
in: query
description: The submission date and time to filter from. This should be in the format yyyy-MM-dd HH:mm:ssZ.
required: true
schema:
type: string
format: date-time
example: '2025-06-25 00:00:00Z'
example: '2025-06-25 00:00:00Z'
- name: submissionDateTimeTo
in: query
description: The submission date and time to filter to. This should be in the format yyyy-MM-dd HH:mm:ssZ.
required: true
schema:
type: string
format: date-time
example: '2025-07-05 00:00:00Z'
example: '2025-07-05 00:00:00Z'
- name: region
in: query
description: The region to filter by.
schema:
enum:
- North Scotland
- South Scotland
- North West
- North East
- Midlands
- South West
- South East
type: string
- name: gspGroupId
in: query
description: The GSP Group ID to filter by.
schema:
type: string
- 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.DatasetResponse-1_Insights.Api.Models.Responses.RestorationZone.RestorationZoneDemandRestoredDatasetRow'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.RestorationZone.RestorationZoneDemandRestoredDatasetRow'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.RestorationZone.RestorationZoneDemandRestoredDatasetRow'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.RestorationZone.RestorationZoneDemandRestoredDatasetRow'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.RestorationZone.RestorationZoneDemandRestoredDatasetRow'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.RestorationZone.RestorationZoneDemandRestoredDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/RZDR/stream:
get:
tags:
- BMRS Datasets
summary: Restoration Region Demand Restored (RZDR) Stream
description: 'This endpoint provides the restored demand value for each restoration region with filtering by submission time, region, and GSP Group ID (when received by NESO).
This endpoint has an optimised JSON payload and is aimed at frequent requests for the data.'
parameters:
- name: submissionDateTimeFrom
in: query
description: The submission date and time to filter from. This should be in the format yyyy-MM-dd HH:mm:ssZ.
required: true
schema:
type: string
format: date-time
example: '2025-06-25 00:00:00Z'
example: '2025-06-25 00:00:00Z'
- name: submissionDateTimeTo
in: query
description: The submission date and time to filter to. This should be in the format yyyy-MM-dd HH:mm:ssZ.
required: true
schema:
type: string
format: date-time
example: '2025-07-05 00:00:00Z'
example: '2025-07-05 00:00:00Z'
- name: region
in: query
description: The region to filter by.
schema:
enum:
- North Scotland
- South Scotland
- North West
- North East
- Midlands
- South West
- South East
type: string
- name: gspGroupId
in: query
description: The GSP Group ID to filter by.
schema:
type: string
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.RestorationZone.RestorationZoneDemandRestoredDatasetRow'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.RestorationZone.RestorationZoneDemandRestoredDatasetRow'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.RestorationZone.RestorationZoneDemandRestoredDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/SIL:
get:
tags:
- BMRS Datasets
summary: Stable Import Limit (SIL)
description: "This endpoint provides Stable Import Limit data received from NGESO.\nStable Import Limit is a negative megawatt value, expressing the minimum stable operating level at which a particular BM Unit can import power from the transmission system.\n \nIf no date window is chosen, the search will default to results from last 24 hours."
parameters:
- name: from
in: query
description: The start of the data time window.
schema:
type: string
format: date-time
example: 2022-07-20T13:15Z
example: 2022-07-20T13:15Z
- name: to
in: query
description: The end of the data time window.
schema:
type: string
format: date-time
example: 2022-07-21T13:15Z
example: 2022-07-21T13:15Z
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- T_KILLPG-1
example:
- T_KILLPG-1
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.StablePortageLimitData'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.StablePortageLimitData'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.StablePortageLimitData'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.StablePortageLimitData'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.StablePortageLimitData'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.StablePortageLimitData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/SIL/stream:
get:
tags:
- BMRS Datasets
summary: Stable Import Limit (SIL) stream
description: "This endpoint provides Stable Import Limit data received from NGESO.\nStable Import Limit is a negative megawatt value, expressing the minimum stable operating level at which a particular BM Unit can import power from the transmission system.\n \nIf no date window is chosen, the search will default to results from last 24 hours.\n \nThis endpoint has an optimised JSON payload and is aimed at frequent requests for SIL data."
parameters:
- name: from
in: query
description: The start of the data time window.
schema:
type: string
format: date-time
example: 2022-07-20T13:15Z
example: 2022-07-20T13:15Z
- name: to
in: query
description: The end of the data time window.
schema:
type: string
format: date-time
example: 2022-07-21T13:15Z
example: 2022-07-21T13:15Z
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- T_KILLPG-1
example:
- T_KILLPG-1
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.StablePortageLimitData'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.StablePortageLimitData'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.StablePortageLimitData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/SEL:
get:
tags:
- BMRS Datasets
summary: Stable Export Limit (SEL)
description: "This endpoint provides Stable Export Limit data received from NGESO.\nStable Export Limit is a positive megawatt value, expressing the minimum stable operating level at which a particular BM Unit can export power to the transmission system.\n \nIf no date window is chosen, the search will default to results from last 24 hours."
parameters:
- name: from
in: query
description: The start of the data time window.
schema:
type: string
format: date-time
example: 2022-07-20T13:15Z
example: 2022-07-20T13:15Z
- name: to
in: query
description: The end of the data time window.
schema:
type: string
format: date-time
example: 2022-07-21T13:15Z
example: 2022-07-21T13:15Z
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- T_KILLPG-1
example:
- T_KILLPG-1
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.StablePortageLimitData'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.StablePortageLimitData'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.StablePortageLimitData'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.StablePortageLimitData'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.StablePortageLimitData'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.StablePortageLimitData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/SEL/stream:
get:
tags:
- BMRS Datasets
summary: Stable Export Limit (SEL) stream
description: "This endpoint provides Stable Export Limit data received from NGESO.\nStable Export Limit is a positive megawatt value, expressing the minimum stable operating level at which a particular BM Unit can export power to the transmission system.\n \nIf no date window is chosen, the search will default to results from last 24 hours.\n \nThis endpoint has an optimised JSON payload and is aimed at frequent requests for SEL data."
parameters:
- name: from
in: query
description: The start of the data time window.
schema:
type: string
format: date-time
example: 2022-07-20T13:15Z
example: 2022-07-20T13:15Z
- name: to
in: query
description: The end of the data time window.
schema:
type: string
format: date-time
example: 2022-07-21T13:15Z
example: 2022-07-21T13:15Z
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- T_KILLPG-1
example:
- T_KILLPG-1
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.StablePortageLimitData'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.StablePortageLimitData'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.StablePortageLimitData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/MZT:
get:
tags:
- BMRS Datasets
summary: Minimum Zero Time (MZT)
description: "This endpoint provides Minimum Zero Time data received from NGESO.\n\nThe Minimum Zero Time is the minimum time that a BM Unit which has been exporting must operate at zero or import, before returning to export;\nwhereas if the BM Unit has been importing, the MZT indicates the minimum time that it must operate at zero or export before returning to import,\nif action by the System Operator (i.e. a Bid-Offer Acceptance) places it at such a level.\n \nBy default, the from and to parameters filter the data by time inclusively. If the settlementPeriodFrom or\nsettlementPeriodTo parameters are provided, the corresponding from or to parameter instead filters on settlement\ndate, allowing for searching by a combination of time and/or settlement date & settlement period.\nNote: When filtering via settlement date, from/to are treated as Dates only, with the time being ignored. For\nexample, 2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.\n \nAll Dates and DateTimes should be expressed as defined within\nRFC 3339.\n \nSome examples of date parameter combinations are shown below.\n \nFiltering from start time to start time:\n \n /datasets/MZT?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z\n \nFiltering from start time to settlement date and period:\n \n /datasets/MZT?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodTo=1\n \nFiltering from settlement date and period to start time:\n \n /datasets/MZT?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1\n \nFiltering from settlement date and period to settlement date and period:\n \n /datasets/MZT?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1"
parameters:
- name: from
in: query
description: The "from" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-01T00:00Z
example: 2022-08-01T00:00Z
- name: to
in: query
description: The "to" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-02T00:00Z
example: 2022-08-02T00:00Z
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- T_FOYE-1
example:
- T_FOYE-1
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryPeriodMinData'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryPeriodMinData'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryPeriodMinData'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryPeriodMinData'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryPeriodMinData'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryPeriodMinData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/MZT/stream:
get:
tags:
- BMRS Datasets
summary: Minimum Zero Time (MZT) stream
description: "This endpoint provides Minimum Zero Time data received from NGESO.\n\nThe Minimum Zero Time is the minimum time that a BM Unit which has been exporting must operate at zero or import, before returning to export;\nwhereas if the BM Unit has been importing, the MZT indicates the minimum time that it must operate at zero or export before returning to import,\nif action by the System Operator (i.e. a Bid-Offer Acceptance) places it at such a level.\n \nBy default, the from and to parameters filter the data by time inclusively. If the settlementPeriodFrom or\nsettlementPeriodTo parameters are provided, the corresponding from or to parameter instead filters on settlement\ndate, allowing for searching by a combination of time and/or settlement date & settlement period.\nNote: When filtering via settlement date, from/to are treated as Dates only, with the time being ignored. For\nexample, 2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.\n \n /// All Dates and DateTimes should be expressed as defined within\nRFC 3339.\n \nSome examples of date parameter combinations are shown below.\n \nFiltering from start time to start time:\n \n /datasets/MZT/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z\n \nFiltering from start time to settlement date and period:\n \n /datasets/MZT/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodTo=1\n \nFiltering from settlement date and period to start time:\n \n /datasets/MZT/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1\n \nFiltering from settlement date and period to settlement date and period:\n \n /datasets/MZT/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1\n\nThis endpoint has an optimised JSON payload and is aimed at frequent requests for MZT data."
parameters:
- name: from
in: query
description: The "from" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-01T00:00Z
example: 2022-08-01T00:00Z
- name: to
in: query
description: The "to" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-02T00:00Z
example: 2022-08-02T00:00Z
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- T_FOYE-1
example:
- T_FOYE-1
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryPeriodMinData'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryPeriodMinData'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryPeriodMinData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/MNZT:
get:
tags:
- BMRS Datasets
summary: Minimum Non-Zero Time (MNZT)
description: "This endpoint provides Minimum Non Zero Time data received from NGESO.\n\nThe Minimum Non-Zero Time represents the minimum time that a BM Unit can operate at a non-zero level as a result of a Bid-Offer Acceptance.\n \nBy default, the from and to parameters filter the data by time inclusively. If the settlementPeriodFrom or\nsettlementPeriodTo parameters are provided, the corresponding from or to parameter instead filters on settlement\ndate, allowing for searching by a combination of time and/or settlement date & settlement period.\nNote: When filtering via settlement date, from/to are treated as Dates only, with the time being ignored. For\nexample, 2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.\n \nAll Dates and DateTimes should be expressed as defined within\nRFC 3339.\n \nSome examples of date parameter combinations are shown below.\n \nFiltering from start time to start time:\n \n /datasets/MNZT?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z\n \nFiltering from start time to settlement date and period:\n \n /datasets/MNZT?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodTo=1\n \nFiltering from settlement date and period to start time:\n \n /datasets/MNZT?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1\n \nFiltering from settlement date and period to settlement date and period:\n \n /datasets/MNZT?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1"
parameters:
- name: from
in: query
description: The "from" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-01T00:00Z
example: 2022-08-01T00:00Z
- name: to
in: query
description: The "to" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-02T00:00Z
example: 2022-08-02T00:00Z
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- T_FOYE-1
example:
- T_FOYE-1
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryPeriodMinData'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryPeriodMinData'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryPeriodMinData'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryPeriodMinData'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryPeriodMinData'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryPeriodMinData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/MNZT/stream:
get:
tags:
- BMRS Datasets
summary: Minimum Non-Zero Time (MNZT) stream
description: "This endpoint provides Minimum Non Zero Time data received from NGESO.\n\nThe Minimum Non-Zero Time represents the minimum time that a BM Unit can operate at a non-zero level as a result of a Bid-Offer Acceptance.\n \nBy default, the from and to parameters filter the data by time inclusively. If the settlementPeriodFrom or\nsettlementPeriodTo parameters are provided, the corresponding from or to parameter instead filters on settlement\ndate, allowing for searching by a combination of time and/or settlement date & settlement period.\nNote: When filtering via settlement date, from/to are treated as Dates only, with the time being ignored. For\nexample, 2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.\n \nAll Dates and DateTimes should be expressed as defined within\nRFC 3339.\n \nSome examples of date parameter combinations are shown below.\n \nFiltering from start time to start time:\n \n /datasets/MNZT/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z\n \nFiltering from start time to settlement date and period:\n \n /datasets/MNZT/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodTo=1\n \nFiltering from settlement date and period to start time:\n \n /datasets/MNZT/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1\n \nFiltering from settlement date and period to settlement date and period:\n \n /datasets/MNZT/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1\n \nThis endpoint has an optimised JSON payload and is aimed at frequent requests for MNZT data."
parameters:
- name: from
in: query
description: The "from" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-01T00:00Z
example: 2022-08-01T00:00Z
- name: to
in: query
description: The "to" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-02T00:00Z
example: 2022-08-02T00:00Z
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- T_FOYE-1
example:
- T_FOYE-1
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryPeriodMinData'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryPeriodMinData'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryPeriodMinData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/MDV:
get:
tags:
- BMRS Datasets
summary: Maximum Delivery Volume (MDV)
description: "This endpoint provides Maximum Delivery Volume data received from NGESO.\n \nMaximum Delivery Volume is the maximum number of MWh of Offer (or Bid), that a particular BM Unit\nmay deliver within the associated Maximum Delivery Period.\n \nBy default, the from and to parameters filter the data by time inclusively. If the settlementPeriodFrom or\nsettlementPeriodTo parameters are provided, the corresponding from or to parameter instead filters on settlement\ndate, allowing for searching by a combination of time and/or settlement date & settlement period.\nNote: When filtering via settlement date, from/to are treated as Dates only, with the time being ignored. For\nexample, 2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.\n \nAll Dates and DateTimes should be expressed as defined within\nRFC 3339.\n \nSome examples of date parameter combinations are shown below.\n \nFiltering from start time to start time:\n \n /datasets/MDV?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z\n \nFiltering from start time to settlement date and period:\n \n /datasets/MDV?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodTo=1\n \nFiltering from settlement date and period to start time:\n \n /datasets/MDV?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1\n \nFiltering from settlement date and period to settlement date and period:\n \n /datasets/MDV?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1"
parameters:
- name: from
in: query
description: The "from" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-01T00:00Z
example: 2022-08-01T00:00Z
- name: to
in: query
description: The "to" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-02T00:00Z
example: 2022-08-02T00:00Z
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- T_FOYE-1
example:
- T_FOYE-1
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryVolumeMaxData'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryVolumeMaxData'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryVolumeMaxData'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryVolumeMaxData'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryVolumeMaxData'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryVolumeMaxData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/MDV/stream:
get:
tags:
- BMRS Datasets
summary: Maximum Delivery Volume (MDV) stream
description: "This endpoint provides Maximum Delivery Volume data received from NGESO.\n \nMaximum Delivery Volume is the maximum number of MWh of Offer (or Bid), that a particular BM Unit\nmay deliver within the associated Maximum Delivery Period.\n \nBy default, the from and to parameters filter the data by time inclusively. If the settlementPeriodFrom or\nsettlementPeriodTo parameters are provided, the corresponding from or to parameter instead filters on settlement\ndate, allowing for searching by a combination of time and/or settlement date & settlement period.\nNote: When filtering via settlement date, from/to are treated as Dates only, with the time being ignored. For\nexample, 2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.\n \nAll Dates and DateTimes should be expressed as defined within\nRFC 3339.\n \nSome examples of date parameter combinations are shown below.\n \nFiltering from start time to start time:\n \n /datasets/MDV/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z\n \nFiltering from start time to settlement date and period:\n \n /datasets/MDV/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodTo=1\n \nFiltering from settlement date and period to start time:\n \n /datasets/MDV/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1\n \nFiltering from settlement date and period to settlement date and period:\n \n /datasets/MDV/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1\n\nThis endpoint has an optimised JSON payload and is aimed at frequent requests for MDV data."
parameters:
- name: from
in: query
description: The "from" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-01T00:00Z
example: 2022-08-01T00:00Z
- name: to
in: query
description: The "to" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-02T00:00Z
example: 2022-08-02T00:00Z
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- T_FOYE-1
example:
- T_FOYE-1
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryVolumeMaxData'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryVolumeMaxData'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryVolumeMaxData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/MDP:
get:
tags:
- BMRS Datasets
summary: Maximum Delivery Period (MDP)
description: "Maximum Delivery Period (MDP) is the maximum period, expressed in minutes, over which the\nMaximum Delivery Volume (MDV) applies. Maximum Delivery Volume is the maximum number of MWh of Offer (or Bid)\nthat a particular BM Unit may deliver within the associated Maximum Delivery Period.\n \nBy default, the from and to parameters filter the data by time inclusively. If the settlementPeriodFrom or\nsettlementPeriodTo parameters are provided, the corresponding from or to parameter instead filters on settlement\ndate, allowing for searching by a combination of time and/or settlement date & settlement period.\nNote: When filtering via settlement date, from/to are treated as Dates only, with the time being ignored. For\nexample, 2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.\n \nAll Dates and DateTimes should be expressed as defined within\nRFC 3339.\n \nSome examples of date parameter combinations are shown below.\n \nFiltering from start time to start time:\n \n /datasets/MDP?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z\n \nFiltering from start time to settlement date and period:\n \n /datasets/MDP?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodTo=1\n \nFiltering from settlement date and period to start time:\n \n /datasets/MDP?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1\n \nFiltering from settlement date and period to settlement date and period:\n \n /datasets/MDP?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1"
parameters:
- name: from
in: query
description: The "from" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-01T00:00Z
example: 2022-08-01T00:00Z
- name: to
in: query
description: The "to" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-02T00:00Z
example: 2022-08-02T00:00Z
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- T_FOYE-1
example:
- T_FOYE-1
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryPeriodMaxData'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryPeriodMaxData'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryPeriodMaxData'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryPeriodMaxData'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryPeriodMaxData'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryPeriodMaxData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/MDP/stream:
get:
tags:
- BMRS Datasets
summary: Maximum Delivery Period (MDP) stream
description: "This endpoint provides Maximum Delivery Period data received from NGESO.\n \nMaximum Delivery Period (MDP) is the maximum period over which the Maximum Delivery Volume (MDV) applies.\n \nBy default, the from and to parameters filter the data by time inclusively. If the settlementPeriodFrom or\nsettlementPeriodTo parameters are provided, the corresponding from or to parameter instead filters on settlement\ndate, allowing for searching by a combination of time and/or settlement date & settlement period.\nNote: When filtering via settlement date, from/to are treated as Dates only, with the time being ignored. For\nexample, 2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.\n \nAll Dates and DateTimes should be expressed as defined within\nRFC 3339.\n \nSome examples of date parameter combinations are shown below.\n \nFiltering from start time to start time:\n \n /datasets/MDP/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z\n \nFiltering from start time to settlement date and period:\n \n /datasets/MDP/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodTo=1\n \nFiltering from settlement date and period to start time:\n \n /datasets/MDP/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1\n \nFiltering from settlement date and period to settlement date and period:\n \n /datasets/MDP/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1\n\nThis endpoint has an optimised JSON payload and is aimed at frequent requests for MDP data."
parameters:
- name: from
in: query
description: The "from" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-01T00:00Z
example: 2022-08-01T00:00Z
- name: to
in: query
description: The "to" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-02T00:00Z
example: 2022-08-02T00:00Z
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- T_FOYE-1
example:
- T_FOYE-1
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryPeriodMaxData'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryPeriodMaxData'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryPeriodMaxData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/NTB:
get:
tags:
- BMRS Datasets
summary: Notice to Deliver Bids (NTB)
description: "This endpoint provides Notice to Deliver Bids data received from NGESO.\n \nNotice to Deliver Bids (NTB) indicates the length of time between the issuing of a Bid-Offer Acceptance and the\ntime when a BM Unit begins to deliver Bid volumes, expressed in minutes.\n \nBy default, the from and to parameters filter the data by time inclusively. If the settlementPeriodFrom or\nsettlementPeriodTo parameters are provided, the corresponding from or to parameter instead filters on settlement\ndate, allowing for searching by a combination of time and/or settlement date & settlement period.\nNote: When filtering via settlement date, from/to are treated as Dates only, with the time being ignored. For\nexample, 2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.\n \nAll Dates and DateTimes should be expressed as defined within\nRFC 3339.\n \nSome examples of date parameter combinations are shown below.\n \nFiltering from start time to start time:\n \n /datasets/NTB?from=2022-06-01T00:00Z&to=2022-06-08T00:00Z\n \nFiltering from start time to settlement date and period:\n \n /datasets/NTB?from=2022-06-01T00:00Z&to=2022-06-08T00:00Z&settlementPeriodTo=1\n \nFiltering from settlement date and period to start time:\n \n /datasets/NTB?from=2022-06-01T00:00Z&to=2022-06-08T00:00Z&settlementPeriodFrom=1\n \nFiltering from settlement date and period to settlement date and period:\n \n /datasets/NTB?from=2022-06-01T00:00Z&to=2022-06-08T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1"
parameters:
- name: from
in: query
description: The "from" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-01T00:00Z
example: 2022-08-01T00:00Z
- name: to
in: query
description: The "to" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-02T00:00Z
example: 2022-08-02T00:00Z
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- T_FOYE-1
example:
- T_FOYE-1
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.NoticeData'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.NoticeData'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.NoticeData'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.NoticeData'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.NoticeData'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.NoticeData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/NTB/stream:
get:
tags:
- BMRS Datasets
summary: Notice to Deliver Bids (NTB) stream
description: "This endpoint provides Notice to Deliver Bids data received from NGESO.\n \nNotice to Deliver Bids (NTB) indicates the length of time between the issuing of a Bid-Offer Acceptance and the\ntime when a BM Unit begins to deliver Bid volumes, expressed in minutes.\n \nBy default, the from and to parameters filter the data by time inclusively. If the settlementPeriodFrom or\nsettlementPeriodTo parameters are provided, the corresponding from or to parameter instead filters on settlement\ndate, allowing for searching by a combination of time and/or settlement date & settlement period.\nNote: When filtering via settlement date, from/to are treated as Dates only, with the time being ignored. For\nexample, 2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.\n \nAll Dates and DateTimes should be expressed as defined within\nRFC 3339.\n \nSome examples of date parameter combinations are shown below.\n \nFiltering from start time to start time:\n \n /datasets/NTB/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z\n \nFiltering from start time to settlement date and period:\n \n /datasets/NTB/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodTo=1\n \nFiltering from settlement date and period to start time:\n \n /datasets/NTB/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1\n \nFiltering from settlement date and period to settlement date and period:\n \n /datasets/NTB/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1\n\nThis endpoint has an optimised JSON payload and is aimed at frequent requests for NTB data."
parameters:
- name: from
in: query
description: The "from" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-01T00:00Z
example: 2022-08-01T00:00Z
- name: to
in: query
description: The "to" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-02T00:00Z
example: 2022-08-02T00:00Z
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- T_FOYE-1
example:
- T_FOYE-1
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.NoticeData'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.NoticeData'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.NoticeData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/NTO:
get:
tags:
- BMRS Datasets
summary: Notice to Deliver Offers (NTO)
description: "This endpoint provides Notice to Deliver Offers data received from NGESO.\n \nNotice to Deliver Offers (NTO) indicates the length of time required for a BM Unit to start delivering Offers\nfrom the time that the Bid-Offer Acceptance is issued, expressed in minutes.\n \nBy default, the from and to parameters filter the data by time inclusively. If the settlementPeriodFrom or\nsettlementPeriodTo parameters are provided, the corresponding from or to parameter instead filters on settlement\ndate, allowing for searching by a combination of time and/or settlement date & settlement period.\nNote: When filtering via settlement date, from/to are treated as Dates only, with the time being ignored. For\nexample, 2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.\n \nAll Dates and DateTimes should be expressed as defined within\nRFC 3339.\n \nSome examples of date parameter combinations are shown below.\n \nFiltering from start time to start time:\n \n /datasets/NTO?from=2022-06-01T00:00Z&to=2022-06-08T00:00Z\n \nFiltering from start time to settlement date and period:\n \n /datasets/NTO?from=2022-06-01T00:00Z&to=2022-06-08T00:00Z&settlementPeriodTo=1\n \nFiltering from settlement date and period to start time:\n \n /datasets/NTO?from=2022-06-01T00:00Z&to=2022-06-08T00:00Z&settlementPeriodFrom=1\n \nFiltering from settlement date and period to settlement date and period:\n \n /datasets/NTO?from=2022-06-01T00:00Z&to=2022-06-08T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1"
parameters:
- name: from
in: query
description: The "from" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-01T00:00Z
example: 2022-08-01T00:00Z
- name: to
in: query
description: The "to" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-02T00:00Z
example: 2022-08-02T00:00Z
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- T_FOYE-1
example:
- T_FOYE-1
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.NoticeData'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.NoticeData'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.NoticeData'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.NoticeData'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.NoticeData'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.NoticeData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/NTO/stream:
get:
tags:
- BMRS Datasets
summary: Notice to Deliver Offers (NTO) stream
description: "This endpoint provides Notice to Deliver Offers data received from NGESO.\n \nNotice to Deliver Offers (NTO) indicates the length of time required for a BM Unit to start delivering Offers\nfrom the time that the Bid-Offer Acceptance is issued, expressed in minutes.\n \nBy default, the from and to parameters filter the data by time inclusively. If the settlementPeriodFrom or\nsettlementPeriodTo parameters are provided, the corresponding from or to parameter instead filters on settlement\ndate, allowing for searching by a combination of time and/or settlement date & settlement period.\nNote: When filtering via settlement date, from/to are treated as Dates only, with the time being ignored. For\nexample, 2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.\n \nAll Dates and DateTimes should be expressed as defined within\nRFC 3339.\n \nSome examples of date parameter combinations are shown below.\n \nFiltering from start time to start time:\n \n /datasets/NTO/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z\n \nFiltering from start time to settlement date and period:\n \n /datasets/NTO/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodTo=1\n \nFiltering from settlement date and period to start time:\n \n /datasets/NTO/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1\n \nFiltering from settlement date and period to settlement date and period:\n \n /datasets/NTO/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1\n\nThis endpoint has an optimised JSON payload and is aimed at frequent requests for NTO data."
parameters:
- name: from
in: query
description: The "from" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-01T00:00Z
example: 2022-08-01T00:00Z
- name: to
in: query
description: The "to" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-02T00:00Z
example: 2022-08-02T00:00Z
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- T_FOYE-1
example:
- T_FOYE-1
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.NoticeData'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.NoticeData'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.NoticeData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/NDZ:
get:
tags:
- BMRS Datasets
summary: Notice to Deviate from Zero (NDZ)
description: "This endpoint provides Notice to Deviate from Zero data received from NGESO.\n \nNotice to Deviate from Zero (NDZ) indicates the length of time required for a BM Unit to start importing or\nexporting energy, from a zero Physical Notification level as a result of a Bid-Offer Acceptance, expressed in\nminutes.\n \nBy default, the from and to parameters filter the data by time inclusively. If the settlementPeriodFrom or\nsettlementPeriodTo parameters are provided, the corresponding from or to parameter instead filters on settlement\ndate, allowing for searching by a combination of time and/or settlement date & settlement period.\nNote: When filtering via settlement date, from/to are treated as Dates only, with the time being ignored. For\nexample, 2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.\n \nAll Dates and DateTimes should be expressed as defined within\nRFC 3339.\n \nSome examples of date parameter combinations are shown below.\n \nFiltering from start time to start time:\n \n /datasets/NDZ?from=2022-06-01T00:00Z&to=2022-06-08T00:00Z\n \nFiltering from start time to settlement date and period:\n \n /datasets/NDZ?from=2022-06-01T00:00Z&to=2022-06-08T00:00Z&settlementPeriodTo=1\n \nFiltering from settlement date and period to start time:\n \n /datasets/NDZ?from=2022-06-01T00:00Z&to=2022-06-08T00:00Z&settlementPeriodFrom=1\n \nFiltering from settlement date and period to settlement date and period:\n \n /datasets/NDZ?from=2022-06-01T00:00Z&to=2022-06-08T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1"
parameters:
- name: from
in: query
description: The "from" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-01T00:00Z
example: 2022-08-01T00:00Z
- name: to
in: query
description: The "to" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-02T00:00Z
example: 2022-08-02T00:00Z
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- T_FOYE-1
example:
- T_FOYE-1
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.NoticeData'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.NoticeData'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.NoticeData'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.NoticeData'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.NoticeData'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.NoticeData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/NDZ/stream:
get:
tags:
- BMRS Datasets
summary: Notice to Deviate from Zero (NDZ) stream
description: "This endpoint provides Notice to Deviate from Zero data received from NGESO.\n \nNotice to Deviate from Zero (NDZ) indicates the length of time required for a BM Unit to start importing or\nexporting energy, from a zero Physical Notification level as a result of a Bid-Offer Acceptance, expressed in\nminutes.\n \nBy default, the from and to parameters filter the data by time inclusively. If the settlementPeriodFrom or\nsettlementPeriodTo parameters are provided, the corresponding from or to parameter instead filters on settlement\ndate, allowing for searching by a combination of time and/or settlement date & settlement period.\nNote: When filtering via settlement date, from/to are treated as Dates only, with the time being ignored. For\nexample, 2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.\n \nAll Dates and DateTimes should be expressed as defined within\nRFC 3339.\n \nSome examples of date parameter combinations are shown below.\n \nFiltering from start time to start time:\n \n /datasets/NDZ/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z\n \nFiltering from start time to settlement date and period:\n \n /datasets/NDZ/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodTo=1\n \nFiltering from settlement date and period to start time:\n \n /datasets/NDZ/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1\n \nFiltering from settlement date and period to settlement date and period:\n \n /datasets/NDZ/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1\n\nThis endpoint has an optimised JSON payload and is aimed at frequent requests for NDZ data."
parameters:
- name: from
in: query
description: The "from" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-01T00:00Z
example: 2022-08-01T00:00Z
- name: to
in: query
description: The "to" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-02T00:00Z
example: 2022-08-02T00:00Z
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- T_FOYE-1
example:
- T_FOYE-1
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.NoticeData'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.NoticeData'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.NoticeData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/RURE:
get:
tags:
- BMRS Datasets
summary: Run Up Rate Export (RURE)
description: "This endpoint provides Run Up Rate Export data received from NGESO.\n \nRun Up Rate Export (RURE) expresses the rate of increase in active power production (MW/minute)\nfor a particular BM Unit which is exporting power within a particular operating range.\nThere can be up to three of these for a given BM Unit.\n \nBy default, the from and to parameters filter the data by time inclusively. If the settlementPeriodFrom or\nsettlementPeriodTo parameters are provided, the corresponding from or to parameter instead filters on settlement\ndate, allowing for searching by a combination of time and/or settlement date & settlement period.\nNote: When filtering via settlement date, from/to are treated as Dates only, with the time being ignored. For\nexample, 2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.\n \nAll Dates and DateTimes should be expressed as defined within\nRFC 3339.\n \nSome examples of date parameter combinations are shown below.\n \nFiltering from start time to start time:\n \n /datasets/rure?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z\n \nFiltering from start time to settlement date and period:\n \n /datasets/rure?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodTo=1\n \nFiltering from settlement date and period to start time:\n \n /datasets/rure?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1\n \nFiltering from settlement date and period to settlement date and period:\n \n /datasets/rure?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1"
parameters:
- name: from
in: query
description: The "from" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-01T00:00Z
example: 2022-08-01T00:00Z
- name: to
in: query
description: The "to" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-02T00:00Z
example: 2022-08-02T00:00Z
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- T_FOYE-1
example:
- T_FOYE-1
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.RateData'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.RateData'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.RateData'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.RateData'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.RateData'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.RateData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/RURE/stream:
get:
tags:
- BMRS Datasets
summary: Run Up Rate Export (RURE) stream
description: "This endpoint provides Run Up Rate Export data received from NGESO.\n \nRun Up Rate Export (RURE) expresses the rate of increase in active power production (MW/minute)\nfor a particular BM Unit which is exporting power within a particular operating range.\nThere can be up to three of these for a given BM Unit.\n \nBy default, the from and to parameters filter the data by time inclusively. If the settlementPeriodFrom or\nsettlementPeriodTo parameters are provided, the corresponding from or to parameter instead filters on settlement\ndate, allowing for searching by a combination of time and/or settlement date & settlement period.\nNote: When filtering via settlement date, from/to are treated as Dates only, with the time being ignored. For\nexample, 2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.\n \nAll Dates and DateTimes should be expressed as defined within\nRFC 3339.\n \nSome examples of date parameter combinations are shown below.\n \nFiltering from start time to start time:\n \n /datasets/rure/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z\n \nFiltering from start time to settlement date and period:\n \n /datasets/rure/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodTo=1\n \nFiltering from settlement date and period to start time:\n \n /datasets/rure/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1\n \nFiltering from settlement date and period to settlement date and period:\n \n /datasets/rure/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1\n\nThis endpoint has an optimised JSON payload and is aimed at frequent requests for QAS data."
parameters:
- name: from
in: query
description: The "from" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-01T00:00Z
example: 2022-08-01T00:00Z
- name: to
in: query
description: The "to" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-02T00:00Z
example: 2022-08-02T00:00Z
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- T_FOYE-1
example:
- T_FOYE-1
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.RateData'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.RateData'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.RateData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/RDRE:
get:
tags:
- BMRS Datasets
summary: Run Down Rate Export (RDRE)
description: "This endpoint provides Run Down Rate Export data received from NGESO.\n \nRun Down Rate Export (RDRE) expresses the rate of decrease in active power production (MW/minute)\nfor a particular BM Unit which is exporting power within a particular operating range. \nThere can be up to three of these for a given BM Unit.\n \nBy default, the from and to parameters filter the data by time inclusively. If the settlementPeriodFrom or\nsettlementPeriodTo parameters are provided, the corresponding from or to parameter instead filters on settlement\ndate, allowing for searching by a combination of time and/or settlement date & settlement period.\nNote: When filtering via settlement date, from/to are treated as Dates only, with the time being ignored. For\nexample, 2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.\n \nAll Dates and DateTimes should be expressed as defined within\nRFC 3339.\n \nSome examples of date parameter combinations are shown below.\n \nFiltering from start time to start time:\n \n /datasets/rdre?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z\n \nFiltering from start time to settlement date and period:\n \n /datasets/rdre?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodTo=1\n \nFiltering from settlement date and period to start time:\n \n /datasets/rdre?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1\n \nFiltering from settlement date and period to settlement date and period:\n \n /datasets/rdre?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1"
parameters:
- name: from
in: query
description: The "from" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-01T00:00Z
example: 2022-08-01T00:00Z
- name: to
in: query
description: The "to" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-02T00:00Z
example: 2022-08-02T00:00Z
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- T_FOYE-1
example:
- T_FOYE-1
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.RateData'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.RateData'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.RateData'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.RateData'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.RateData'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.RateData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/RDRE/stream:
get:
tags:
- BMRS Datasets
summary: Run Down Rate Export (RDRE) stream
description: "This endpoint provides Run Down Rate Export data received from NGESO.\n \nRun Down Rate Export (RDRE) expresses the rate of decrease in active power production (MW/minute)\nfor a particular BM Unit which is exporting power within a particular operating range. \nThere can be up to three of these for a given BM Unit.\n \nBy default, the from and to parameters filter the data by time inclusively. If the settlementPeriodFrom or\nsettlementPeriodTo parameters are provided, the corresponding from or to parameter instead filters on settlement\ndate, allowing for searching by a combination of time and/or settlement date & settlement period.\nNote: When filtering via settlement date, from/to are treated as Dates only, with the time being ignored. For\nexample, 2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.\n \nAll Dates and DateTimes should be expressed as defined within\nRFC 3339.\n \nSome examples of date parameter combinations are shown below.\n \nFiltering from start time to start time:\n \n /datasets/rdre/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z\n \nFiltering from start time to settlement date and period:\n \n /datasets/rdre/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodTo=1\n \nFiltering from settlement date and period to start time:\n \n /datasets/rdre/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1\n \nFiltering from settlement date and period to settlement date and period:\n \n /datasets/rdre/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1\n\nThis endpoint has an optimised JSON payload and is aimed at frequent requests for QAS data."
parameters:
- name: from
in: query
description: The "from" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-01T00:00Z
example: 2022-08-01T00:00Z
- name: to
in: query
description: The "to" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-02T00:00Z
example: 2022-08-02T00:00Z
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- T_FOYE-1
example:
- T_FOYE-1
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.RateData'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.RateData'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.RateData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/RURI:
get:
tags:
- BMRS Datasets
summary: Run Up Rate Import (RURI)
description: "This endpoint provides Run Up Rate Import data received from NGESO.\n \nRun Up Rate Import (RURI) expresses the rate of decrease in active power consumption (MW/minute)\nfor a particular BM Unit which is importing power within a particular operating range.\nThere can be up to three of these for a given BM Unit.\n \nBy default, the from and to parameters filter the data by time inclusively. If the settlementPeriodFrom or\nsettlementPeriodTo parameters are provided, the corresponding from or to parameter instead filters on settlement\ndate, allowing for searching by a combination of time and/or settlement date & settlement period.\nNote: When filtering via settlement date, from/to are treated as Dates only, with the time being ignored. For\nexample, 2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.\n \nAll Dates and DateTimes should be expressed as defined within\nRFC 3339.\n \nSome examples of date parameter combinations are shown below.\n \nFiltering from start time to start time:\n \n /datasets/ruri?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z\n \nFiltering from start time to settlement date and period:\n \n /datasets/ruri?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodTo=1\n \nFiltering from settlement date and period to start time:\n \n /datasets/ruri?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1\n \nFiltering from settlement date and period to settlement date and period:\n \n /datasets/ruri?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1"
parameters:
- name: from
in: query
description: The "from" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-01T00:00Z
example: 2022-08-01T00:00Z
- name: to
in: query
description: The "to" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-02T00:00Z
example: 2022-08-02T00:00Z
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- T_FOYE-1
example:
- T_FOYE-1
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.RateData'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.RateData'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.RateData'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.RateData'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.RateData'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.RateData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/RURI/stream:
get:
tags:
- BMRS Datasets
summary: Run Up Rate Import (RURI) stream
description: "This endpoint provides Run Up Rate Import data received from NGESO.\n \nRun Up Rate Import (RURI) expresses the rate of decrease in active power consumption (MW/minute)\nfor a particular BM Unit which is importing power within a particular operating range. \nThere can be up to three of these for a given BM Unit.\n \nBy default, the from and to parameters filter the data by time inclusively. If the settlementPeriodFrom or\nsettlementPeriodTo parameters are provided, the corresponding from or to parameter instead filters on settlement\ndate, allowing for searching by a combination of time and/or settlement date & settlement period.\nNote: When filtering via settlement date, from/to are treated as Dates only, with the time being ignored. For\nexample, 2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.\n \nAll Dates and DateTimes should be expressed as defined within\nRFC 3339.\n \nSome examples of date parameter combinations are shown below.\n \nFiltering from start time to start time:\n \n /datasets/ruri/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z\n \nFiltering from start time to settlement date and period:\n \n /datasets/ruri/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodTo=1\n \nFiltering from settlement date and period to start time:\n \n /datasets/ruri/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1\n \nFiltering from settlement date and period to settlement date and period:\n \n /datasets/ruri/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1\n\nThis endpoint has an optimised JSON payload and is aimed at frequent requests for QAS data."
parameters:
- name: from
in: query
description: The "from" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-01T00:00Z
example: 2022-08-01T00:00Z
- name: to
in: query
description: The "to" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-02T00:00Z
example: 2022-08-02T00:00Z
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- T_FOYE-1
example:
- T_FOYE-1
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.RateData'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.RateData'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.RateData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/RDRI:
get:
tags:
- BMRS Datasets
summary: Run Down Rate Import (RDRI)
description: "This endpoint provides Run Down Rate Import data received from NGESO.\n \nRun Down Rate Import (RDRI) expresses the rate of increase in active power consumption (MW/minute)\nfor a particular BM Unit which is importing power within a particular operating range.\nThere can be up to three of these for a given BM Unit.\n \nBy default, the from and to parameters filter the data by time inclusively. If the settlementPeriodFrom or\nsettlementPeriodTo parameters are provided, the corresponding from or to parameter instead filters on settlement\ndate, allowing for searching by a combination of time and/or settlement date & settlement period.\nNote: When filtering via settlement date, from/to are treated as Dates only, with the time being ignored. For\nexample, 2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.\n \nAll Dates and DateTimes should be expressed as defined within\nRFC 3339.\n \nSome examples of date parameter combinations are shown below.\n \nFiltering from start time to start time:\n \n /datasets/rdri?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z\n \nFiltering from start time to settlement date and period:\n \n /datasets/rdri?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodTo=1\n \nFiltering from settlement date and period to start time:\n \n /datasets/rdri?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1\n \nFiltering from settlement date and period to settlement date and period:\n \n /datasets/rdri?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1"
parameters:
- name: from
in: query
description: The "from" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-01T00:00Z
example: 2022-08-01T00:00Z
- name: to
in: query
description: The "to" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-02T00:00Z
example: 2022-08-02T00:00Z
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- T_FOYE-1
example:
- T_FOYE-1
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.RateData'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.RateData'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.RateData'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.RateData'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.RateData'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.RateData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/RDRI/stream:
get:
tags:
- BMRS Datasets
summary: Run Down Rate Import (RDRI) stream
description: "This endpoint provides Run Down Rate Import data received from NGESO.\n \nRun Down Rate Import (RDRI) expresses the rate of increase in active power consumption (MW/minute)\nfor a particular BM Unit which is importing power within a particular operating range. \nThere can be up to three of these for a given BM Unit.\n \nBy default, the from and to parameters filter the data by time inclusively. If the settlementPeriodFrom or\nsettlementPeriodTo parameters are provided, the corresponding from or to parameter instead filters on settlement\ndate, allowing for searching by a combination of time and/or settlement date & settlement period.\nNote: When filtering via settlement date, from/to are treated as Dates only, with the time being ignored. For\nexample, 2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.\n \nAll Dates and DateTimes should be expressed as defined within\nRFC 3339.\n \nSome examples of date parameter combinations are shown below.\n \nFiltering from start time to start time:\n \n /datasets/rdri/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z\n \nFiltering from start time to settlement date and period:\n \n /datasets/rdri/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodTo=1\n \nFiltering from settlement date and period to start time:\n \n /datasets/rdri/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1\n \nFiltering from settlement date and period to settlement date and period:\n \n /datasets/rdri/stream?from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1\n\nThis endpoint has an optimised JSON payload and is aimed at frequent requests for QAS data."
parameters:
- name: from
in: query
description: The "from" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-01T00:00Z
example: 2022-08-01T00:00Z
- name: to
in: query
description: The "to" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-02T00:00Z
example: 2022-08-02T00:00Z
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: bmUnit
in: query
description: The BM units to query. Add each unit separately. If no BM unit is selected all BM units will be displayed.
schema:
type: array
items:
type: string
example:
- T_FOYE-1
example:
- T_FOYE-1
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.RateData'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.RateData'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.RateData'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/REMIT:
get:
tags:
- BMRS Datasets
summary: The Regulation on Wholesale Energy Markets Integrity and Transparency (REMIT)
description: "The Regulation on Wholesale Energy Markets Integrity and Transparency (REMIT) is an EU regulation aimed at preventing market abuse in wholesale energy markets.\n\nThis endpoint returns information provided by market participants to comply with Article 4 of Regulation on Wholesale Energy Market Integrity and Transparency (REMIT) Regulation (EU) 1227/2011.\n \nOnly JSON and XML formats are supported for this endpoint."
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: 2023/04/13 07:00
example: 2023/04/13 07:00
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: 2023/04/13 10:00
example: 2023/04/13 10:00
- name: format
in: query
description: Response data format. Use json/xml to include metadata.
schema:
enum:
- json
- xml
type: string
responses:
'200':
description: Data retrieved
content:
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.Remit.DatasetRows.RemitMessage'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.Remit.DatasetRows.RemitMessage'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/REMIT/stream:
get:
tags:
- BMRS Datasets
summary: The Regulation on Wholesale Energy Markets Integrity and Transparency (REMIT) stream
description: 'The Regulation on Wholesale Energy Markets Integrity and Transparency (REMIT) is an EU regulation aimed at preventing market abuse in wholesale energy markets.
This endpoint returns information provided by market participants to comply with Article 4 of Regulation on Wholesale Energy Market Integrity and Transparency (REMIT) Regulation (EU) 1227/2011.
This endpoint has an optimised JSON payload and is aimed at frequent requests for the data.'
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: 2023/04/13 07:00
example: 2023/04/13 07:00
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: 2023/04/13 10:00
example: 2023/04/13 10:00
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.Remit.DatasetRows.RemitMessage'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.Remit.DatasetRows.RemitMessage'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.Remit.DatasetRows.RemitMessage'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/AGWS:
get:
tags:
- BMRS Datasets
summary: Actual Or Estimated Wind And Solar Power Generation (AGWS / B1630)
description: "This endpoint provides actual or estimated wind and solar power generation\nper settlement period. It returns generation with Power System Resource type\nSolar, Wind Onshore or Wind Offshore (Fuel Type categories as defined by\nCommission Regulation (EU) No 543/2013).\n \nThis API endpoint provides a maximum data output range of 7 days."
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: '2023-07-27T10:00:00Z'
example: '2023-07-27T10:00:00Z'
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: '2023-07-28T10:00:00Z'
example: '2023-07-28T10:00:00Z'
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.ActualGenerationWindSolarDatasetRow'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.ActualGenerationWindSolarDatasetRow'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.ActualGenerationWindSolarDatasetRow'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.ActualGenerationWindSolarDatasetRow'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.ActualGenerationWindSolarDatasetRow'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.ActualGenerationWindSolarDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/AGWS/stream:
get:
tags:
- BMRS Datasets
summary: Actual Or Estimated Wind And Solar Power Generation (AGWS / B1630) stream
description: "This endpoint provides actual or estimated wind and solar power generation\nper settlement period. It returns generation with Power System Resource type\nSolar, Wind Onshore or Wind Offshore (Fuel Type categories as defined by\nCommission Regulation (EU) No 543/2013).\n \nThis endpoint has an optimised JSON payload and is aimed at frequent requests for the data."
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: '2023-07-27T10:00:00Z'
example: '2023-07-27T10:00:00Z'
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: '2023-07-28T10:00:00Z'
example: '2023-07-28T10:00:00Z'
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.ActualGenerationWindSolarDatasetRow'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.ActualGenerationWindSolarDatasetRow'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.ActualGenerationWindSolarDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/DGWS:
get:
tags:
- BMRS Datasets
summary: Day-Ahead Generation For Wind And Solar (DGWS / B1440)
description: 'This endpoint provides day-ahead generation data for wind and solar.
This API endpoint provides a maximum data output range of 7 days.'
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: 2023/07/18 07:00
example: 2023/07/18 07:00
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: 2023/07/21 10:00
example: 2023/07/21 10:00
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.DayAheadGenerationForWindAndSolarDatasetRow'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.DayAheadGenerationForWindAndSolarDatasetRow'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.DayAheadGenerationForWindAndSolarDatasetRow'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.DayAheadGenerationForWindAndSolarDatasetRow'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.DayAheadGenerationForWindAndSolarDatasetRow'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.DayAheadGenerationForWindAndSolarDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/DGWS/stream:
get:
tags:
- BMRS Datasets
summary: Day-Ahead Generation For Wind And Solar (DGWS / B1440) stream
description: "This endpoint provides day-ahead generation data for wind and solar.\n \nThis endpoint has an optimised JSON payload and is aimed at frequent requests for the data."
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: 2023/07/18 07:00
example: 2023/07/18 07:00
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: 2023/07/21 10:00
example: 2023/07/21 10:00
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.DayAheadGenerationForWindAndSolarDatasetRow'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.DayAheadGenerationForWindAndSolarDatasetRow'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.DayAheadGenerationForWindAndSolarDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/AGPT:
get:
tags:
- BMRS Datasets
summary: Actual Aggregated Generation Per Type (AGPT / B1620)
description: "This endpoint provides actual generation data per settlement period aggregated by Power System Resource type (Fuel Type categories as defined by Commission Regulation (EU) No 543/2013).\n \nThis endpoint filters by publishTime and provides a maximum data output range of 4 days."
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: 2023-07-18 18:00
example: 2023-07-18 18:00
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: 2023-07-21 09:00
example: 2023-07-21 09:00
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.ActualAggregatedGenerationPerTypeDatasetRow'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.ActualAggregatedGenerationPerTypeDatasetRow'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.ActualAggregatedGenerationPerTypeDatasetRow'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.ActualAggregatedGenerationPerTypeDatasetRow'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.ActualAggregatedGenerationPerTypeDatasetRow'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.ActualAggregatedGenerationPerTypeDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/AGPT/stream:
get:
tags:
- BMRS Datasets
summary: Actual Aggregated Generation Per Type (AGPT / B1620) stream
description: "This endpoint provides actual generation data per settlement period aggregated by Power System Resource type (Fuel Type categories as defined by Commission Regulation (EU) No 543/2013).\n \nThis endpoint filters by publishTime and has an optimised JSON payload aimed at frequent requests for the data."
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: 2023-07-18 18:00
example: 2023-07-18 18:00
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: 2023-07-21 09:00
example: 2023-07-21 09:00
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.ActualAggregatedGenerationPerTypeDatasetRow'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.ActualAggregatedGenerationPerTypeDatasetRow'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.ActualAggregatedGenerationPerTypeDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/B1610:
get:
tags:
- BMRS Datasets
summary: Actual Generation Output Per Generation Unit (B1610)
description: "This endpoint provides the actual metered volume output (MWh) per Settlement Period for all BM units (Positive, Negative or zero MWh values).\n \nThe settlement period to query must be specified as a date and settlement period. The date must be given in the format yyyy-MM-dd.\n \nThe information is published five days after the end of the operational period based on the Interim Information (II) Settlement Run and the data is refreshed by subsequent Settlement Runs.\n \nThe generation output returned by this endpoint is the metered volume and not the instantaneous power output as often appears in other specifications."
parameters:
- name: settlementDate
in: query
required: true
schema:
type: string
format: date
example: '2022-08-12'
example: '2022-08-12'
- name: settlementPeriod
in: query
required: true
schema:
type: integer
format: int32
example: 10
example: 10
- name: bmUnit
in: query
schema:
type: array
items:
type: string
example:
- T_CNQPS-1
example:
- T_CNQPS-1
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.ActualGenerationOutputPerGenerationUnitDatasetResponse'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.ActualGenerationOutputPerGenerationUnitDatasetResponse'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.ActualGenerationOutputPerGenerationUnitDatasetResponse'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.ActualGenerationOutputPerGenerationUnitDatasetResponse'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.ActualGenerationOutputPerGenerationUnitDatasetResponse'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.ActualGenerationOutputPerGenerationUnitDatasetResponse'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/B1610/stream:
get:
tags:
- BMRS Datasets
summary: Actual Generation Output Per Generation Unit (B1610) stream
description: "This endpoint provides the actual metered volume output (MWh) per Settlement Period for all BM units (Positive, Negative or zero MWh values).\n \nThe information is published five days after the end of the operational period based on the Interim Information (II) Settlement Run and the data is refreshed by subsequent Settlement Runs.\n \nThe generation output returned by this endpoint is the metered volume and not the instantaneous power output as often appears in other specifications.\n\nThis endpoint has an optimised JSON payload and is aimed at frequent requests for the data."
parameters:
- name: from
in: query
description: The "from" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-12T00:00Z
example: 2022-08-12T00:00Z
- name: to
in: query
description: The "to" start time or settlement date for the filter.
required: true
schema:
type: string
format: date-time
example: 2022-08-14T00:00Z
example: 2022-08-14T00:00Z
- name: settlementPeriodFrom
in: query
description: The "from" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: settlementPeriodTo
in: query
description: The "to" settlement period for the filter. This should be an integer from 1-50 inclusive.
schema:
type: integer
format: int32
- name: bmUnit
in: query
schema:
type: array
items:
type: string
example:
- T_CNQPS-1
example:
- T_CNQPS-1
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.ActualGenerationOutputPerGenerationUnitDatasetResponse'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.ActualGenerationOutputPerGenerationUnitDatasetResponse'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.ActualGenerationOutputPerGenerationUnitDatasetResponse'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/IGCA:
get:
tags:
- BMRS Datasets
summary: Installed Generation Capacity Aggregated (IGCA / B1410)
description: 'This endpoint provides installed generation capacity aggregated data.
This API endpoint provides a maximum data output range of 2 years (731 days).'
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: '2022-04-20T00:00:00Z'
example: '2022-04-20T00:00:00Z'
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: '2022-04-27T00:00:00Z'
example: '2022-04-27T00:00:00Z'
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.IgcaDatasetRow'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.IgcaDatasetRow'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.IgcaDatasetRow'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.IgcaDatasetRow'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.IgcaDatasetRow'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.IgcaDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/IGCA/stream:
get:
tags:
- BMRS Datasets
summary: Installed Generation Capacity Aggregated (IGCA / B1410) stream
description: "This endpoint provides installed generation capacity aggregated data.\n \nThis endpoint has an optimised JSON payload and is aimed at frequent requests for the data."
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: '2022-04-20T00:00:00Z'
example: '2022-04-20T00:00:00Z'
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: '2022-04-27T00:00:00Z'
example: '2022-04-27T00:00:00Z'
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.IgcaDatasetRow'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.IgcaDatasetRow'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.IgcaDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/IGCPU:
get:
tags:
- BMRS Datasets
summary: Installed Generation Capacity per Unit (IGCPU / B1420)
description: "This endpoint provides information about production units (existing and planned)\nwith an installed generation capacity equaling to or exceeding 100 MW. \n \nThe database was populated from a data dump lacking publishTime values,\nall entries were assigned a default publishTime of 2023-01-01 00:00 during the migration.\n\nThis API endpoint provides a maximum data output range of 2 years (731 days)."
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: '2023-01-01T00:00:00Z'
example: '2023-01-01T00:00:00Z'
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: '2024-01-02T00:00:00Z'
example: '2024-01-02T00:00:00Z'
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.IgcpuDatasetRow'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.IgcpuDatasetRow'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.IgcpuDatasetRow'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.IgcpuDatasetRow'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.IgcpuDatasetRow'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.IgcpuDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/IGCPU/stream:
get:
tags:
- BMRS Datasets
summary: Installed Generation Capacity per Unit (IGCPU / B1420) stream
description: "This endpoint provides information about production units (existing and planned)\nwith an installed generation capacity equaling to or exceeding 100 MW. \n \nThe database was populated from a data dump lacking publishTime values,\nall entries were assigned a default publishTime of 2023-01-01 00:00 during the migration.\n\nThis endpoint has an optimised JSON payload and is aimed at frequent requests for the data."
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: '2023-01-01T00:00:00Z'
example: '2023-01-01T00:00:00Z'
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: '2024-01-02T00:00:00Z'
example: '2024-01-02T00:00:00Z'
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.IgcpuDatasetRow'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.IgcpuDatasetRow'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.IgcpuDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/ATL:
get:
tags:
- BMRS Datasets
summary: Actual Total Load Per Bidding Zone (ATL / B0610)
description: 'This endpoint provides actual total load per bidding zone data.
This API endpoint provides a maximum data output range of 7 days.'
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: '2023-07-18T07:00:00Z'
example: '2023-07-18T07:00:00Z'
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: '2023-07-21T10:00:00Z'
example: '2023-07-21T10:00:00Z'
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.ActualTotalLoadPerBiddingZoneDatasetRow'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.ActualTotalLoadPerBiddingZoneDatasetRow'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.ActualTotalLoadPerBiddingZoneDatasetRow'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.ActualTotalLoadPerBiddingZoneDatasetRow'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.ActualTotalLoadPerBiddingZoneDatasetRow'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.ActualTotalLoadPerBiddingZoneDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/ATL/stream:
get:
tags:
- BMRS Datasets
summary: Actual Total Load Per Bidding Zone (ATL / B0610) stream
description: "This endpoint provides actual total load per bidding zone data.\n \nThis endpoint has an optimised JSON payload and is aimed at frequent requests for the data."
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: '2023-07-18T07:00:00Z'
example: '2023-07-18T07:00:00Z'
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: '2023-07-21T10:00:00Z'
example: '2023-07-21T10:00:00Z'
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.ActualTotalLoadPerBiddingZoneDatasetRow'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.ActualTotalLoadPerBiddingZoneDatasetRow'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.ActualTotalLoadPerBiddingZoneDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/DATL:
get:
tags:
- BMRS Datasets
summary: Day-Ahead Total Load Forecast Per Bidding Zone (DATL / B0620)
description: 'This endpoint provides day-ahead total load forecast per bidding zone data.
This API endpoint provides a maximum data output range of 7 days.'
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: 2023/07/18 07:00
example: 2023/07/18 07:00
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: 2023/07/21 10:00
example: 2023/07/21 10:00
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.DayAheadTotalLoadPerBiddingZoneDatasetRow'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.DayAheadTotalLoadPerBiddingZoneDatasetRow'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.DayAheadTotalLoadPerBiddingZoneDatasetRow'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.DayAheadTotalLoadPerBiddingZoneDatasetRow'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.DayAheadTotalLoadPerBiddingZoneDatasetRow'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.DayAheadTotalLoadPerBiddingZoneDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/DATL/stream:
get:
tags:
- BMRS Datasets
summary: Day-Ahead Total Load Forecast Per Bidding Zone (DATL / B0620) stream
description: 'This endpoint provides day-ahead total load forecast per bidding zone data.
This endpoint has an optimised JSON payload and is aimed at frequent requests for the data.'
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: 2023/07/18 07:00
example: 2023/07/18 07:00
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: 2023/07/21 10:00
example: 2023/07/21 10:00
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.DayAheadTotalLoadPerBiddingZoneDatasetRow'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.DayAheadTotalLoadPerBiddingZoneDatasetRow'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.DayAheadTotalLoadPerBiddingZoneDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/WATL:
get:
tags:
- BMRS Datasets
summary: Week-Ahead Total Load Forecast Per Bidding Zone (WATL / B0630)
description: 'This endpoint provides week-ahead total load forecast per bidding zone data with minimum possible
and maximum available loads provided in MW values.
This API endpoint has a maximum range of 367 days.'
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: 2022-06-25T00:00Z
example: 2022-06-25T00:00Z
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: 2022-07-25T00:00Z
example: 2022-07-25T00:00Z
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.WeekAheadTotalLoadPerBiddingZoneDatasetRow'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.WeekAheadTotalLoadPerBiddingZoneDatasetRow'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.WeekAheadTotalLoadPerBiddingZoneDatasetRow'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.WeekAheadTotalLoadPerBiddingZoneDatasetRow'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.WeekAheadTotalLoadPerBiddingZoneDatasetRow'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.WeekAheadTotalLoadPerBiddingZoneDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/WATL/stream:
get:
tags:
- BMRS Datasets
summary: Week-Ahead Total Load Forecast Per Bidding Zone (WATL / B0630) stream
description: 'This endpoint provides week-ahead total load forecast per bidding zone data with minimum possible
and maximum available loads provided in MW values.
This endpoint has an optimised JSON payload and is aimed at frequent requests for the data.'
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: 2022-06-25T00:00Z
example: 2022-06-25T00:00Z
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: 2022-07-25T00:00Z
example: 2022-07-25T00:00Z
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.WeekAheadTotalLoadPerBiddingZoneDatasetRow'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.WeekAheadTotalLoadPerBiddingZoneDatasetRow'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.WeekAheadTotalLoadPerBiddingZoneDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/DAG:
get:
tags:
- BMRS Datasets
summary: Day-Ahead Aggregated Generation (DAG / B1430)
description: "This endpoint provides day-ahead aggregated generation data.\n \nIt has a maximum date range of 7 days."
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: 2023-07-18 18:00
example: 2023-07-18 18:00
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: 2023-07-21 09:00
example: 2023-07-21 09:00
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.DayAheadAggregatedGenerationDatasetRow'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.DayAheadAggregatedGenerationDatasetRow'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.DayAheadAggregatedGenerationDatasetRow'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.DayAheadAggregatedGenerationDatasetRow'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.DayAheadAggregatedGenerationDatasetRow'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.DayAheadAggregatedGenerationDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/DAG/stream:
get:
tags:
- BMRS Datasets
summary: Day-Ahead Aggregated Generation (DAG / B1430) stream
description: "This endpoint provides day-ahead aggregated generation data.\n \nThis endpoint has an optimised JSON payload and is aimed at frequent requests for the data."
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: 2023-07-18 18:00
example: 2023-07-18 18:00
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: 2023-07-21 09:00
example: 2023-07-21 09:00
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.DayAheadAggregatedGenerationDatasetRow'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.DayAheadAggregatedGenerationDatasetRow'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.DayAheadAggregatedGenerationDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/MATL:
get:
tags:
- BMRS Datasets
summary: Month-Ahead Total Load Forecast Per Bidding Zone (MATL / B0640)
description: 'This endpoint provides month-ahead total load per bidding zone forecast data with minimum possible
and maximum available loads provided in MW values.
This API endpoint has a maximum range of 367 days.'
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: 2022-06-25T00:00Z
example: 2022-06-25T00:00Z
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: 2022-07-25T00:00Z
example: 2022-07-25T00:00Z
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.MonthAheadTotalLoadPerBiddingZoneDatasetRow'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.MonthAheadTotalLoadPerBiddingZoneDatasetRow'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.MonthAheadTotalLoadPerBiddingZoneDatasetRow'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.MonthAheadTotalLoadPerBiddingZoneDatasetRow'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.MonthAheadTotalLoadPerBiddingZoneDatasetRow'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.MonthAheadTotalLoadPerBiddingZoneDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/MATL/stream:
get:
tags:
- BMRS Datasets
summary: Month-Ahead Total Load Forecast Per Bidding Zone (MATL / B0640) stream
description: 'This endpoint provides month-ahead total load per bidding zone forecast data with minimum possible
and maximum available loads provided in MW values.
This endpoint has an optimised JSON payload and is aimed at frequent requests for the data.'
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: 2022-06-25T00:00Z
example: 2022-06-25T00:00Z
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: 2022-07-25T00:00Z
example: 2022-07-25T00:00Z
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.MonthAheadTotalLoadPerBiddingZoneDatasetRow'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.MonthAheadTotalLoadPerBiddingZoneDatasetRow'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.MonthAheadTotalLoadPerBiddingZoneDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/YATL:
get:
tags:
- BMRS Datasets
summary: Year-Ahead Total Load Forecast Per Bidding Zone (YATL / B0650)
description: 'This endpoint provides year-ahead total load per bidding zone forecast data with minimum possible
and maximum available loads provided in MW values.
This API endpoint has a maximum range of 367 days.'
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: 2022-06-25T00:00Z
example: 2022-06-25T00:00Z
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: 2022-07-25T00:00Z
example: 2022-07-25T00:00Z
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.YearAheadTotalLoadPerBiddingZoneDatasetRow'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.YearAheadTotalLoadPerBiddingZoneDatasetRow'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.YearAheadTotalLoadPerBiddingZoneDatasetRow'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.YearAheadTotalLoadPerBiddingZoneDatasetRow'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.YearAheadTotalLoadPerBiddingZoneDatasetRow'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.YearAheadTotalLoadPerBiddingZoneDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/YATL/stream:
get:
tags:
- BMRS Datasets
summary: Year-Ahead Total Load Forecast Per Bidding Zone (YATL / B0650) stream
description: 'This endpoint provides year-ahead total load per bidding zone forecast data with minimum possible
and maximum available loads provided in MW values.
This endpoint has an optimised JSON payload and is aimed at frequent requests for the data.'
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: 2022-06-25T00:00Z
example: 2022-06-25T00:00Z
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: 2022-07-25T00:00Z
example: 2022-07-25T00:00Z
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.YearAheadTotalLoadPerBiddingZoneDatasetRow'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.YearAheadTotalLoadPerBiddingZoneDatasetRow'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.YearAheadTotalLoadPerBiddingZoneDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/CCM:
get:
tags:
- BMRS Datasets
summary: Cost of Congestion Management (CCM / B1330)
description: 'This endpoint provides cost of congestion management data.
This API endpoint has a maximum range of 2 years (731 days).'
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: 2022-06-25T00:00Z
example: 2022-06-25T00:00Z
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: 2022-07-25T00:00Z
example: 2022-07-25T00:00Z
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.CostsOfCongestionManagementDatasetRow'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.CostsOfCongestionManagementDatasetRow'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.CostsOfCongestionManagementDatasetRow'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.CostsOfCongestionManagementDatasetRow'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.CostsOfCongestionManagementDatasetRow'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.CostsOfCongestionManagementDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/CCM/stream:
get:
tags:
- BMRS Datasets
summary: Cost of Congestion Management (CCM / B1330) stream
description: 'This endpoint provides cost of congestion management data.
This endpoint has an optimised JSON payload and is aimed at frequent requests for the data.'
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: 2022-06-25T00:00Z
example: 2022-06-25T00:00Z
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: 2022-07-25T00:00Z
example: 2022-07-25T00:00Z
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.CostsOfCongestionManagementDatasetRow'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.CostsOfCongestionManagementDatasetRow'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.CostsOfCongestionManagementDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/YAFM:
get:
tags:
- BMRS Datasets
summary: Year Ahead Forecast Margin (YAFM / B0810)
description: "This endpoint provides year-ahead forecast margin data.\n \nA year-ahead forecast margin is defined as the difference between yearly forecast of available generation capacity and yearly forecast of total load,\ntaking into account the forecast of total generation capacity, forecast of availability of generation and forecast of reserves contracted for system services.\n\nThis API endpoint has a maximum range of 20 years (7305 days)."
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: 2021-06-01T00:00Z
example: 2021-06-01T00:00Z
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: 2022-07-25T00:00Z
example: 2022-07-25T00:00Z
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.YearAheadForecastMarginDatasetRow'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.YearAheadForecastMarginDatasetRow'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.YearAheadForecastMarginDatasetRow'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.YearAheadForecastMarginDatasetRow'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.YearAheadForecastMarginDatasetRow'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.YearAheadForecastMarginDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/YAFM/stream:
get:
tags:
- BMRS Datasets
summary: Year Ahead Forecast Margin (YAFM / B0810) stream
description: "This endpoint provides year-ahead forecast margin data.\n\nA year-ahead forecast margin is defined as the difference between yearly forecast of available generation capacity and yearly forecast of total load,\ntaking into account the forecast of total generation capacity, forecast of availability of generation and forecast of reserves contracted for system services.\n \nThis endpoint has an optimised JSON payload and is aimed at frequent requests for the data."
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: 2021-06-01T00:00Z
example: 2021-06-01T00:00Z
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: 2022-07-25T00:00Z
example: 2022-07-25T00:00Z
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.YearAheadForecastMarginDatasetRow'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.YearAheadForecastMarginDatasetRow'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.YearAheadForecastMarginDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/ABUC:
get:
tags:
- BMRS Datasets
summary: Amount Of Balancing Reserves Under Contract (ABUC / B1720)
description: 'This endpoint provides amount of balancing reserves under contract data.
This API endpoint has a maximum range of 2 years (731 days).'
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: '2023-08-22T01:00:00Z'
example: '2023-08-22T01:00:00Z'
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: '2023-08-23T01:00:00Z'
example: '2023-08-23T01:00:00Z'
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.AbucDatasetRow'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.AbucDatasetRow'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.AbucDatasetRow'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.AbucDatasetRow'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.AbucDatasetRow'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.AbucDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/ABUC/stream:
get:
tags:
- BMRS Datasets
summary: Amount Of Balancing Reserves Under Contract (ABUC / B1720) stream
description: 'This endpoint provides amount of balancing reserves under contract data.
This endpoint has an optimised JSON payload and is aimed at frequent requests for the data.'
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: '2023-08-22T01:00:00Z'
example: '2023-08-22T01:00:00Z'
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: '2023-08-23T01:00:00Z'
example: '2023-08-23T01:00:00Z'
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.AbucDatasetRow'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.AbucDatasetRow'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.AbucDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/PPBR:
get:
tags:
- BMRS Datasets
summary: Prices Of Procured Balancing Reserves (PPBR / B1730)
description: 'This endpoint provides prices of procured balancing reserves.
This API endpoint has a maximum range of 2 years (731 days).'
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: '2023-09-12T01:00:00Z'
example: '2023-09-12T01:00:00Z'
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: '2023-09-17T01:00:00Z'
example: '2023-09-17T01:00:00Z'
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.PpbrDatasetRow'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.PpbrDatasetRow'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.PpbrDatasetRow'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.PpbrDatasetRow'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.PpbrDatasetRow'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.PpbrDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/PPBR/stream:
get:
tags:
- BMRS Datasets
summary: Prices Of Procured Balancing Reserves (PPBR / B1730) stream
description: 'This endpoint provides prices of procured balancing reserves.
This endpoint has an optimised JSON payload and is aimed at frequent requests for the data.'
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: '2023-09-12T01:00:00Z'
example: '2023-09-12T01:00:00Z'
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: '2023-09-17T01:00:00Z'
example: '2023-09-17T01:00:00Z'
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.PpbrDatasetRow'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.PpbrDatasetRow'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.PpbrDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/FEIB:
get:
tags:
- BMRS Datasets
summary: Financial Expenses and Income for Balancing (FEIB / B1790)
description: 'This endpoint provides financial expenses and income for balancing data.
This API endpoint has a maximum range of 1 year (367 days).'
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: 2023-10-12 01:00Z
example: 2023-10-12 01:00Z
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: 2023-11-12 01:00Z
example: 2023-11-12 01:00Z
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.FeibDatasetRow'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.FeibDatasetRow'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.FeibDatasetRow'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.FeibDatasetRow'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.FeibDatasetRow'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.FeibDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/FEIB/stream:
get:
tags:
- BMRS Datasets
summary: Financial Expenses and Income for Balancing (FEIB / B1790) stream
description: 'This endpoint provides financial expenses and income for balancing data.
This endpoint has an optimised JSON payload and is aimed at frequent requests for the data.'
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: 2023-10-12 01:00Z
example: 2023-10-12 01:00Z
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: 2023-11-12 01:00Z
example: 2023-11-12 01:00Z
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.FeibDatasetRow'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.FeibDatasetRow'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.FeibDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/AOBE:
get:
tags:
- BMRS Datasets
summary: Accepted Offered Balancing Energy (AOBE)
description: 'This endpoint provides accepted offered balancing energy data.
This API endpoint has a maximum range of 7 days.'
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: '2023-11-06T00:00:00Z'
example: '2023-11-06T00:00:00Z'
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: '2023-11-13T00:00:00Z'
example: '2023-11-13T00:00:00Z'
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.AobeDatasetRow'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.AobeDatasetRow'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.AobeDatasetRow'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.AobeDatasetRow'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.AobeDatasetRow'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.AobeDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/AOBE/stream:
get:
tags:
- BMRS Datasets
summary: Accepted Offered Balancing Energy (AOBE) stream
description: 'This endpoint provides accepted offered balancing energy data.
This endpoint has an optimised JSON payload and is aimed at frequent requests for the data.'
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: '2023-11-06T00:00:00Z'
example: '2023-11-06T00:00:00Z'
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: '2023-11-13T00:00:00Z'
example: '2023-11-13T00:00:00Z'
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.AobeDatasetRow'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.AobeDatasetRow'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.AobeDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/BEB:
get:
tags:
- BMRS Datasets
summary: Balancing Energy Bids (BEB)
description: 'This endpoint provides information on all balancing energy bids, in accordance with the Electricity Balancing Guidelines (EBGL) article 12.3.b.
This API endpoint has a maximum range of 7 days.'
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: '2023-10-30T14:00:00Z'
example: '2023-10-30T14:00:00Z'
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: '2023-10-30T15:00:00Z'
example: '2023-10-30T15:00:00Z'
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.BebDatasetRow'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.BebDatasetRow'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.BebDatasetRow'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.BebDatasetRow'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.BebDatasetRow'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.BebDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/BEB/stream:
get:
tags:
- BMRS Datasets
summary: Balancing Energy Bids (BEB) stream
description: 'This endpoint provides information on all balancing energy bids, in accordance with the Electricity Balancing Guidelines (EBGL) article 12.3.b.
This endpoint has an optimised JSON payload and is aimed at frequent requests for the data.'
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: '2023-10-30T14:00:00Z'
example: '2023-10-30T14:00:00Z'
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: '2023-10-30T15:00:00Z'
example: '2023-10-30T15:00:00Z'
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.BebDatasetRow'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.BebDatasetRow'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.BebDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/CBS:
get:
tags:
- BMRS Datasets
summary: Current Balancing State (CBS)
description: 'This endpoint provides information on the current system balance, in accordance with the Electricity Balancing Guidelines (EBGL) article 12.3.a.
This API endpoint has a maximum range of 1 day.'
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: '2023-09-11T14:00:07.00Z'
example: '2023-09-11T14:00:07.00Z'
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: '2023-09-11T14:31:07.00Z'
example: '2023-09-11T14:31:07.00Z'
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.CbsDatasetRow'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.CbsDatasetRow'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.CbsDatasetRow'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.CbsDatasetRow'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.CbsDatasetRow'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.CbsDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/CBS/stream:
get:
tags:
- BMRS Datasets
summary: Current Balancing State (CBS) stream
description: 'This endpoint provides information on the current system balance, in accordance with the Electricity Balancing Guidelines (EBGL) article 12.3.a.
This endpoint has an optimised JSON payload and is aimed at frequent requests for the data.'
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: '2023-09-11T14:00:07.00Z'
example: '2023-09-11T14:00:07.00Z'
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: '2023-09-11T14:31:07.00Z'
example: '2023-09-11T14:31:07.00Z'
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.CbsDatasetRow'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.CbsDatasetRow'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.CbsDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/PBC:
get:
tags:
- BMRS Datasets
summary: Procured Balancing Capacity (PBC)
description: 'This endpoint provides information on the procured balancing capacity, in accordance with the Electricity Balancing Guidelines (EBGL) article 12.3.f.
This API endpoint has a maximum range of 1 day.'
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: '2024-02-09T14:00:00Z'
example: '2024-02-09T14:00:00Z'
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: '2024-02-10T14:00:00Z'
example: '2024-02-10T14:00:00Z'
- 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.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.PbcDatasetRow'
application/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.PbcDatasetRow'
text/json:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.PbcDatasetRow'
application/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.PbcDatasetRow'
text/xml:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.PbcDatasetRow'
text/csv:
schema:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.PbcDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
/datasets/PBC/stream:
get:
tags:
- BMRS Datasets
summary: Procured Balancing Capacity (PBC) stream
description: 'This endpoint provides information on the procured balancing capacity, in accordance with the Electricity Balancing Guidelines (EBGL) article 12.3.f.
This endpoint has an optimised JSON payload and is aimed at frequent requests for the data.'
parameters:
- name: publishDateTimeFrom
in: query
required: true
schema:
type: string
format: date-time
example: '2024-02-09T14:00:00Z'
example: '2024-02-09T14:00:00Z'
- name: publishDateTimeTo
in: query
required: true
schema:
type: string
format: date-time
example: '2024-02-10T14:00:00Z'
example: '2024-02-10T14:00:00Z'
responses:
'200':
description: Data retrieved
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.PbcDatasetRow'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.PbcDatasetRow'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.PbcDatasetRow'
'429':
description: Too many requests
'400':
description: Error with query parameters - see response for details
'500':
description: Server error - please try again later
components:
schemas:
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.CostsOfCongestionManagementDatasetRow
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.CostsOfCongestionManagementDatasetRow'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.Transparency.DatasetRows.ActualGenerationWindSolarDatasetRow:
type: object
properties:
dataset:
type: string
nullable: true
example: AGWS
documentId:
type: string
nullable: true
example: NGET-EMFIP-AGWS-20810714
documentRevisionNumber:
type: integer
format: int32
example: 2
publishTime:
type: string
format: date-time
example: '2023-07-12 05:00:00Z'
businessType:
type: string
nullable: true
example: Solar generation
psrType:
type: string
nullable: true
example: Solar
quantity:
type: number
format: double
example: 1829
startTime:
type: string
format: date-time
example: '2023-07-12 06:30:00Z'
settlementDate:
type: string
format: date
example: '2022-07-12'
settlementPeriod:
type: integer
format: int32
example: 16
additionalProperties: false
Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByBmUnitDaily:
type: object
properties:
dataset:
type: string
nullable: true
fuelType:
type: string
nullable: true
example: WIND
nationalGridBmUnit:
type: string
nullable: true
example: WTMSO-1
bmUnit:
type: string
nullable: true
example: T_WTMSO-1
publishTime:
type: string
format: date-time
nullable: true
example: '2022-08-15T11:00:00Z'
forecastDate:
type: string
format: date
example: '2022-08-17'
outputUsable:
type: integer
format: int64
nullable: true
example: 84
additionalProperties: false
Insights.Api.Models.Responses.Misc.DatasetRows.SoSoPricesDatasetRow:
type: object
properties:
dataset:
type: string
nullable: true
example: SOSO
publishTime:
type: string
format: date-time
nullable: true
example: 2022-09-20T00:00Z
senderIdentification:
type: string
nullable: true
example: 10X1001A1001A515
receiverIdentification:
type: string
nullable: true
example: 10X1001A1001A59Q
contractIdentification:
type: string
nullable: true
example: EG_20210928_1100_1
resourceProvider:
type: string
nullable: true
example: EG_20210928_1100_1
tradeDirection:
type: string
nullable: true
example: A02
tradeQuantity:
type: number
format: double
example: 25
tradePrice:
type: number
format: double
example: 30.4
traderUnit:
type: string
nullable: true
example: EWIC_EG
startTime:
type: string
format: date-time
example: 2023-09-25 18:30
endTime:
type: string
format: date-time
example: 2023-09-20 18:30
settlementDate:
type: string
format: date
example: '2023-01-31'
additionalProperties: false
Insights.Api.Models.Responses.Balancing.DatasetRows.BalancingServicesVolumeData:
type: object
properties:
dataset:
type: string
nullable: true
example: QAS
settlementDate:
type: string
format: date
example: '2022-07-25'
settlementPeriod:
type: integer
format: int32
example: 3
bmUnitApplicableBalancingServicesVolume:
type: number
format: double
example: 123.45
nationalGridBmUnit:
type: string
nullable: true
example: ABRBO-1
bmUnit:
type: string
nullable: true
example: T_ABRBO-1
additionalProperties: false
Insights.Api.Models.Responses.Transparency.DatasetRows.PbcDatasetRow:
type: object
properties:
dataset:
type: string
nullable: true
example: PBC
documentId:
type: string
nullable: true
example: NGET-EMFIP-PBC-00688983
timeSeriesId:
type: string
nullable: true
example: NGET-EMFIP-PBC-TS-36758603
documentRevisionNumber:
type: integer
format: int32
example: 1
publishTime:
type: string
format: date-time
example: '2023-08-22T07:43:04Z'
flowDirection:
type: string
nullable: true
example: Up
psrType:
type: string
nullable: true
example: Generation
quantity:
type: number
format: double
example: 1140
procurementPrice:
type: number
format: double
example: 150
startTime:
type: string
format: date-time
example: '2023-08-22T07:43:04Z'
settlementDate:
type: string
format: date
example: '2023-08-23'
settlementPeriod:
type: integer
format: int32
example: 1
additionalProperties: false
Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByFuelTypeWeekly:
type: object
properties:
dataset:
type: string
nullable: true
fuelType:
type: string
nullable: true
publishTime:
type: string
format: date-time
nullable: true
systemZone:
type: string
nullable: true
calendarWeekNumber:
type: integer
format: int32
nullable: true
year:
type: integer
format: int32
nullable: true
outputUsable:
type: integer
format: int64
nullable: true
biddingZone:
type: string
nullable: true
interconnectorName:
type: string
nullable: true
interconnector:
type: boolean
additionalProperties: false
Insights.Api.Models.Responses.Balancing.Dynamic.RateData:
type: object
properties:
dataset:
type: string
nullable: true
example: RURE
settlementDate:
type: string
format: date
example: '2022-07-01'
settlementPeriod:
type: integer
format: int32
example: 3
time:
type: string
format: date-time
example: '2022-07-01T13:34:00Z'
rate1:
type: number
format: double
example: 0.4
elbow2:
type: number
format: double
nullable: true
example: 5
rate2:
type: number
format: double
nullable: true
example: 300.2
elbow3:
type: number
format: double
nullable: true
example: null
rate3:
type: number
format: double
nullable: true
example: null
nationalGridBmUnit:
type: string
nullable: true
example: ABRBO-1
bmUnit:
type: string
nullable: true
example: T_ABRBO-1
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.DayAheadTotalLoadPerBiddingZoneDatasetRow
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.DayAheadTotalLoadPerBiddingZoneDatasetRow'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.NoticeData:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.NoticeData'
nullable: true
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.RestorationZone.RestorationZoneDemandForecastDatasetRow
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.RestorationZone.RestorationZoneDemandForecastDatasetRow'
nullable: true
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.WindGenerationForecast
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Generation.DatasetRows.WindGenerationForecast'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.BebDatasetRow:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.BebDatasetRow'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.Transparency.DatasetRows.YearAheadForecastMarginDatasetRow:
type: object
properties:
dataset:
type: string
nullable: true
example: YAFM
documentId:
type: string
nullable: true
example: NGET-EMFIP-YAFM-00687705
documentRevisionNumber:
type: integer
format: int32
example: 1
publishTime:
type: string
format: date-time
example: '2023-07-12 05:00:00Z'
businessType:
type: string
nullable: true
example: Positive forecast margin
year:
type: integer
format: int32
example: 2023
quantity:
type: number
format: double
example: 1.08
additionalProperties: false
Insights.Api.Models.Responses.Balancing.DatasetRows.NetBalancingServicesAdjustmentData:
type: object
properties:
dataset:
type: string
nullable: true
example: NETBSAD
settlementDate:
type: string
format: date
example: '2022-06-25'
settlementPeriod:
type: integer
format: int32
example: 29
netBuyPriceCostAdjustmentEnergy:
type: number
format: double
example: 0
netBuyPriceVolumeAdjustmentEnergy:
type: number
format: double
example: 0
netBuyPriceVolumeAdjustmentSystem:
type: number
format: double
example: 0
buyPricePriceAdjustment:
type: number
format: double
example: 0
netSellPriceCostAdjustmentEnergy:
type: number
format: double
example: 0
netSellPriceVolumeAdjustmentEnergy:
type: number
format: double
example: 0
netSellPriceVolumeAdjustmentSystem:
type: number
format: double
example: 0
sellPricePriceAdjustment:
type: number
format: double
example: 0
additionalProperties: false
Insights.Api.Models.Responses.ForecastSurplus.DatasetRows.ForecastSurplusWeekly:
type: object
properties:
dataset:
type: string
nullable: true
publishTime:
type: string
format: date-time
week:
type: integer
format: int32
year:
type: integer
format: int32
surplus:
type: integer
format: int64
nullable: true
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByFuelTypeDaily
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByFuelTypeDaily'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.PbcDatasetRow:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.PbcDatasetRow'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.PhysicalNotificationData:
type: object
properties:
dataset:
type: string
nullable: true
example: PN
settlementDate:
type: string
format: date
example: '2022-07-01'
settlementPeriod:
type: integer
format: int32
example: 3
timeFrom:
type: string
format: date-time
example: '2022-07-01T13:34:00Z'
timeTo:
type: string
format: date-time
example: '2022-07-01T13:34:00Z'
levelFrom:
type: integer
format: int32
example: 5
levelTo:
type: integer
format: int32
example: 46
nationalGridBmUnit:
type: string
nullable: true
example: ABRBO-1
bmUnit:
type: string
nullable: true
example: T_ABRBO-1
additionalProperties: false
Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.RateData:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.RateData'
nullable: true
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.ForecastMargin.DatasetRows.ForecastMarginWeekly
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.ForecastMargin.DatasetRows.ForecastMarginWeekly'
nullable: true
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.BidOfferDatasetResponse
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.DatasetRows.BidOfferDatasetResponse'
nullable: true
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.MonthAheadTotalLoadPerBiddingZoneDatasetRow
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.MonthAheadTotalLoadPerBiddingZoneDatasetRow'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.Transparency.DatasetRows.YearAheadTotalLoadPerBiddingZoneDatasetRow:
type: object
properties:
dataset:
type: string
nullable: true
example: YATL
documentId:
type: string
nullable: true
example: NGET-EMFIP-WATL-16209423
documentRevisionNumber:
type: integer
format: int32
example: 1
publishTime:
type: string
format: date-time
example: '2023-07-12 05:00:00Z'
forecastYear:
type: integer
format: int32
example: 2023
forecastWeek:
type: integer
format: int32
example: 30
minimumPossible:
type: number
format: double
example: 18034
maximumAvailable:
type: number
format: double
example: 35011
additionalProperties: false
Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.IgcaDatasetRow:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.IgcaDatasetRow'
nullable: true
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.ActualTotalLoadPerBiddingZoneDatasetRow
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.ActualTotalLoadPerBiddingZoneDatasetRow'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.Generation.DatasetRows.NonBmStorData:
type: object
properties:
dataset:
type: string
nullable: true
example: NONBM
publishTime:
type: string
format: date-time
example: '2022-06-25T13:34:00Z'
startTime:
type: string
format: date-time
example: '2022-06-25T13:00:00Z'
settlementDate:
type: string
format: date
example: '2022-06-25'
settlementPeriod:
type: integer
format: int32
example: 29
generation:
type: integer
format: int64
example: 0
additionalProperties: false
Insights.Api.Models.Responses.Balancing.DatasetRows.DisaggregatedBalancingServicesAdjustmentData:
type: object
properties:
dataset:
type: string
nullable: true
example: DISBSAD
settlementDate:
type: string
format: date
example: '2022-06-25'
settlementPeriod:
type: integer
format: int32
example: 29
id:
type: integer
format: int32
example: 1
cost:
type: number
format: double
nullable: true
example: 1850.9
volume:
type: number
format: double
example: 5
soFlag:
type: boolean
storFlag:
type: boolean
partyId:
type: string
nullable: true
example: ElectroRoute Energy Trading Limited
assetId:
type: string
nullable: true
example: ING-ELTR1
isTendered:
type: boolean
nullable: true
service:
type: string
nullable: true
example: Energy
additionalProperties: false
Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.SoSoPricesDatasetRow:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Misc.DatasetRows.SoSoPricesDatasetRow'
nullable: true
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastTransmissionWeekly
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastTransmissionWeekly'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedMargin:
type: object
properties:
dataset:
type: string
nullable: true
margin:
type: integer
format: int64
nullable: true
publishTime:
type: string
format: date-time
startTime:
type: string
format: date-time
settlementDate:
type: string
format: date
settlementPeriod:
type: integer
format: int32
boundary:
type: string
nullable: true
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.YearAheadTotalLoadPerBiddingZoneDatasetRow
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.YearAheadTotalLoadPerBiddingZoneDatasetRow'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.Remit.DatasetRows.RemitMessage:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.Remit.DatasetRows.RemitMessage'
nullable: true
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.BidOfferAcceptanceLevelDatasetResponse
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.DatasetRows.BidOfferAcceptanceLevelDatasetResponse'
nullable: true
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedDemand
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedDemand'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.Transparency.DatasetRows.MonthAheadTotalLoadPerBiddingZoneDatasetRow:
type: object
properties:
dataset:
type: string
nullable: true
example: MATL
documentId:
type: string
nullable: true
example: NGET-EMFIP-WATL-16209423
documentRevisionNumber:
type: integer
format: int32
example: 1
publishTime:
type: string
format: date-time
example: '2023-05-25 23:00:10Z'
forecastWeekCommencingDate:
type: string
format: date
example: '2023-05-29'
forecastYear:
type: integer
format: int32
example: 2023
forecastMonth:
type: string
nullable: true
example: JUN
minimumPossible:
type: number
format: double
example: 18034
maximumAvailable:
type: number
format: double
example: 35011
additionalProperties: false
Insights.Api.Models.Responses.Transparency.Remit.DatasetRows.RemitMessage:
type: object
properties:
dataset:
type: string
nullable: true
example: REMIT
mrid:
type: string
nullable: true
example: 11XINNOGY------2-NGET-RMT-00084421
revisionNumber:
type: integer
format: int32
example: 25
publishTime:
type: string
format: date-time
example: '2023-01-31T17:39:15Z'
createdTime:
type: string
format: date-time
example: '2023-01-31T17:39:15Z'
messageType:
type: string
nullable: true
example: UnavailabilitiesOfElectricityFacilities
messageHeading:
type: string
nullable: true
example: Planned Unavailability of Generation Unit
eventType:
type: string
nullable: true
example: Production unavailability
unavailabilityType:
type: string
nullable: true
example: Planned
participantId:
type: string
nullable: true
example: 11XINNOGY------2
registrationCode:
type: string
nullable: true
example: 11XINNOGY------2
assetId:
type: string
nullable: true
example: T_DIDCB5
assetType:
type: string
nullable: true
example: Production
affectedUnit:
type: string
nullable: true
example: DIDCB5
affectedUnitEIC:
type: string
nullable: true
example: 48W000000DIDCB5C
affectedArea:
type: string
nullable: true
example: N
biddingZone:
type: string
nullable: true
example: 10YGB----------A
fuelType:
type: string
nullable: true
example: Fossil Gas
normalCapacity:
type: number
format: double
nullable: true
example: 780
availableCapacity:
type: number
format: double
nullable: true
example: 320
unavailableCapacity:
type: number
format: double
nullable: true
example: 361
eventStatus:
type: string
nullable: true
example: Inactive
eventStartTime:
type: string
format: date-time
example: '2022-08-23T06:59:00Z'
eventEndTime:
type: string
format: date-time
nullable: true
example: '2022-08-25T05:20:30Z'
durationUncertainty:
type: string
nullable: true
example: +- 1 day
cause:
type: string
nullable: true
example: Other
relatedInformation:
type: string
nullable: true
example: Status changed to Completed
outageProfile:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.Remit.DatasetRows.OutageProfileData'
nullable: true
example:
- startTime: '2023-02-03T21:06:31.000Z'
endTime: '2023-02-03T21:10:00.000Z'
capacity: 436
additionalProperties: false
Insights.Api.Models.Responses.Generation.DatasetRows.WindGenerationForecast:
type: object
properties:
dataset:
type: string
nullable: true
publishTime:
type: string
format: date-time
startTime:
type: string
format: date-time
generation:
type: integer
format: int64
nullable: true
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.DisaggregatedBalancingServicesAdjustmentData
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.DatasetRows.DisaggregatedBalancingServicesAdjustmentData'
nullable: true
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.MarketIndexDatasetResponse
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.DatasetRows.MarketIndexDatasetResponse'
nullable: true
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.StablePortageLimitData
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.StablePortageLimitData'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.Transparency.DatasetRows.ActualAggregatedGenerationPerTypeDatasetRow:
type: object
properties:
dataset:
type: string
nullable: true
example: AGPT
documentId:
type: string
nullable: true
example: NGET-EMFIP-AGPT-06426954
documentRevisionNumber:
type: integer
format: int32
example: 1
publishTime:
type: string
format: date-time
example: '2023-07-12 05:00:00Z'
businessType:
type: string
nullable: true
example: Solar generation
psrType:
type: string
nullable: true
example: Solar
quantity:
type: number
format: double
example: 1829
startTime:
type: string
format: date-time
example: '2023-07-12 06:30:00Z'
settlementDate:
type: string
format: date
example: '2023-07-12'
settlementPeriod:
type: integer
format: int32
example: 16
additionalProperties: false
Insights.Api.Models.Responses.Misc.DatasetRows.SystemWarningsData:
type: object
properties:
dataset:
type: string
nullable: true
example: SYSWARN
publishTime:
type: string
format: date-time
nullable: true
example: 2022-09-20T00:00Z
warningType:
type: string
nullable: true
example: SO-SO TRADES
warningText:
type: string
nullable: true
example: NATIONAL GRID NOTIFICATION of excess energy prices used for settlement outside of BALIT for SO to SO Transactions
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryPeriodMaxData
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryPeriodMaxData'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastNationalDaily:
type: object
properties:
dataset:
type: string
nullable: true
publishTime:
type: string
format: date-time
forecastDate:
type: string
format: date
demand:
type: integer
format: int64
nullable: true
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.CreditDefaultNoticeDatasetResponse
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.DatasetRows.CreditDefaultNoticeDatasetResponse'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.AobeDatasetRow:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.AobeDatasetRow'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.Balancing.DatasetRows.BidOfferAcceptanceLevelDatasetResponse:
type: object
properties:
dataset:
type: string
nullable: true
example: BOALF
settlementDate:
type: string
format: date
example: '2022-07-25'
settlementPeriodFrom:
type: integer
format: int32
example: 29
settlementPeriodTo:
type: integer
format: int32
example: 32
timeFrom:
type: string
format: date-time
example: '2022-06-25T13:34:00Z'
timeTo:
type: string
format: date-time
example: '2022-06-25T13:37:00Z'
levelFrom:
type: integer
format: int32
example: 5
levelTo:
type: integer
format: int32
example: 46
acceptanceNumber:
type: integer
format: int32
example: 1234567
acceptanceTime:
type: string
format: date-time
example: '2022-06-25T13:37:00Z'
deemedBoFlag:
type: boolean
soFlag:
type: boolean
amendmentFlag:
type: string
nullable: true
example: ORI
storFlag:
type: boolean
rrFlag:
type: boolean
nullable: true
nationalGridBmUnit:
type: string
nullable: true
example: ABRBO-1
bmUnit:
type: string
nullable: true
example: T_ABRBO-1
additionalProperties: false
Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryVolumeMaxData:
type: object
properties:
dataset:
type: string
nullable: true
example: MDV
settlementDate:
type: string
format: date
example: '2022-07-01'
settlementPeriod:
type: integer
format: int32
example: 3
time:
type: string
format: date-time
example: '2022-07-01T13:34:00Z'
volumeMax:
type: integer
format: int64
example: 31
nationalGridBmUnit:
type: string
nullable: true
example: ABRBO-1
bmUnit:
type: string
nullable: true
example: T_ABRBO-1
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.ForecastSurplus.DatasetRows.ForecastSurplusDaily
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.ForecastSurplus.DatasetRows.ForecastSurplusDaily'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.Generation.DatasetRows.AugmentedOutturnData:
type: object
properties:
dataset:
type: string
nullable: true
example: FUELINST
publishTime:
type: string
format: date-time
nullable: true
example: '2022-06-25T13:00:00Z'
startTime:
type: string
format: date-time
nullable: true
example: '2022-06-25T13:00:00Z'
settlementDate:
type: string
format: date
nullable: true
example: '2022-06-25'
settlementPeriod:
type: integer
format: int32
nullable: true
example: 3
fuelType:
type: string
nullable: true
example: BIOMASS
generation:
type: integer
format: int64
nullable: true
example: 0
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.ForecastSurplus.DatasetRows.ForecastSurplusWeekly
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.ForecastSurplus.DatasetRows.ForecastSurplusWeekly'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.DemandOutturn.DatasetRows.IndodDatasetRow:
type: object
properties:
dataset:
type: string
nullable: true
example: INDOD
publishTime:
type: string
format: date-time
example: '2023-08-26T23:15:00Z'
settlementDate:
type: string
format: date
example: '2023-08-26'
demand:
type: integer
format: int64
nullable: true
example: 494802
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandOutturn.DatasetRows.DemandOutturnTransmission
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DemandOutturn.DatasetRows.DemandOutturnTransmission'
nullable: true
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastNationalWeekly
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastNationalWeekly'
nullable: true
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedMargin
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedMargin'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandOutturn.DatasetRows.IndodDatasetRow:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DemandOutturn.DatasetRows.IndodDatasetRow'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.AbucDatasetRow:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.AbucDatasetRow'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.NoticeData:
type: object
properties:
dataset:
type: string
nullable: true
example: NTB
settlementDate:
type: string
format: date
example: '2022-07-01'
settlementPeriod:
type: integer
format: int32
example: 3
time:
type: string
format: date-time
example: '2022-07-01T13:34:00Z'
notice:
type: integer
format: int32
example: 13
nationalGridBmUnit:
type: string
nullable: true
example: ABRBO-1
bmUnit:
type: string
nullable: true
example: T_ABRBO-1
additionalProperties: false
Insights.Api.Models.Responses.Transparency.DatasetRows.ActualTotalLoadPerBiddingZoneDatasetRow:
type: object
properties:
dataset:
type: string
nullable: true
example: ATL
documentId:
type: string
nullable: true
example: NGET-EMFIP-ATL-06424732
documentRevisionNumber:
type: integer
format: int32
example: 1
publishTime:
type: string
format: date-time
example: '2023-06-29 17:25:09Z'
startTime:
type: string
format: date-time
example: '2023-06-29 15:30:00Z'
settlementDate:
type: string
format: date
example: '2023-06-29'
settlementPeriod:
type: integer
format: int32
example: 40
quantity:
type: number
format: double
example: 1000
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.RestorationZone.RestorationZoneDemandRestoredDatasetRow
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.RestorationZone.RestorationZoneDemandRestoredDatasetRow'
nullable: true
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.ForecastMargin.DatasetRows.ForecastMarginDaily
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.ForecastMargin.DatasetRows.ForecastMarginDaily'
nullable: true
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByBmUnitDaily
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByBmUnitDaily'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedGeneration:
type: object
properties:
dataset:
type: string
nullable: true
generation:
type: integer
format: int64
nullable: true
publishTime:
type: string
format: date-time
startTime:
type: string
format: date-time
settlementDate:
type: string
format: date
settlementPeriod:
type: integer
format: int32
boundary:
type: string
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.Transparency.DatasetRows.AbucDatasetRow:
type: object
properties:
dataset:
type: string
nullable: true
example: ABUC
documentId:
type: string
nullable: true
example: NGET-EMFIP-ABUC-00688983
documentRevisionNumber:
type: integer
format: int32
example: 1
publishTime:
type: string
format: date-time
example: '2023-08-22T07:43:04Z'
businessType:
type: string
nullable: true
example: Replacement reserve
psrType:
type: string
nullable: true
example: Generation
marketAgreementType:
type: string
nullable: true
example: Daily
flowDirection:
type: string
nullable: true
example: Up
settlementDate:
type: string
format: date
example: '2023-08-23'
quantity:
type: number
format: double
example: 1140
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.ActualGenerationOutputPerGenerationUnitDatasetResponse
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.ActualGenerationOutputPerGenerationUnitDatasetResponse'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastTransmissionWeekly:
type: object
properties:
dataset:
type: string
nullable: true
publishTime:
type: string
format: date-time
year:
type: integer
format: int32
week:
type: integer
format: int32
demand:
type: integer
format: int64
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.Transparency.DatasetRows.DayAheadTotalLoadPerBiddingZoneDatasetRow:
type: object
properties:
dataset:
type: string
nullable: true
example: DATL
documentId:
type: string
nullable: true
example: NGET-EMFIP-DATL-16244005
documentRevisionNumber:
type: integer
format: int32
example: 1
publishTime:
type: string
format: date-time
example: '2023-08-05 12:00:08Z'
startTime:
type: string
format: date-time
example: '2023-08-06 23:30:00Z'
settlementDate:
type: string
format: date
example: '2023-08-07'
settlementPeriod:
type: integer
format: int32
example: 2
quantity:
type: number
format: double
example: 18648
additionalProperties: false
Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.DeliveryLimitMaxData:
type: object
properties:
dataset:
type: string
nullable: true
example: MILS
settlementDate:
type: string
format: date
example: '2022-07-01'
settlementPeriod:
type: integer
format: int32
example: 3
timeFrom:
type: string
format: date-time
example: '2022-07-01T13:34:00Z'
timeTo:
type: string
format: date-time
example: '2022-07-01T13:34:00Z'
levelFrom:
type: integer
format: int32
example: 5
levelTo:
type: integer
format: int32
example: 46
notificationTime:
type: string
format: date-time
example: '2022-07-01T13:34:00Z'
notificationSequence:
type: integer
format: int32
example: 93210322
nationalGridBmUnit:
type: string
nullable: true
example: ABRBO-1
bmUnit:
type: string
nullable: true
example: T_ABRBO-1
additionalProperties: false
Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.SystemWarningsData:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Misc.DatasetRows.SystemWarningsData'
nullable: true
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastTransmissionDayAhead
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastTransmissionDayAhead'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.Transparency.DatasetRows.AobeDatasetRow:
type: object
properties:
dataset:
type: string
nullable: true
example: AOBE
documentId:
type: string
nullable: true
example: NGET-EMFIP-AOBE-00879999
timeSeriesId:
type: string
nullable: true
example: NGET-EMFIP-AOBE-36758603
documentRevisionNumber:
type: integer
format: int32
example: 1
publishTime:
type: string
format: date-time
example: '2023-10-24T13:09:07Z'
flowDirection:
type: string
nullable: true
example: Up
quantity:
type: number
format: double
example: 12412
secondaryQuantity:
type: number
format: double
nullable: true
example: 45.831
startTime:
type: string
format: date-time
example: '2023-09-11T14:30:00Z'
settlementDate:
type: string
format: date
example: '2023-09-11'
settlementPeriod:
type: integer
format: int32
example: 32
additionalProperties: false
Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityWeekly:
type: object
properties:
dataset:
type: string
nullable: true
publishTime:
type: string
format: date-time
nullable: true
systemZone:
type: string
nullable: true
calendarWeekNumber:
type: integer
format: int32
nullable: true
year:
type: integer
format: int32
nullable: true
outputUsable:
type: integer
format: int64
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.PpbrDatasetRow:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.PpbrDatasetRow'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.Misc.DatasetRows.TudmDatasetRow:
type: object
properties:
dataset:
type: string
nullable: true
example: TUDM
serialNumber:
type: string
nullable: true
example: 000000980321
fileCreationTime:
type: string
format: date-time
example: '2023-10-19T07:01:07.000'
tradingUnitType:
type: string
nullable: true
example: Base
tradingUnitName:
type: string
nullable: true
example: DEFAULT__A
settlementDate:
type: string
format: date
example: '2022-07-30'
settlementPeriod:
type: integer
format: int32
example: 5
settlementRunType:
type: string
nullable: true
example: RF
startTime:
type: string
format: date-time
example: '2022-07-30T10:30:00Z'
deliveryMode:
type: string
nullable: true
example: Offtaking
importVolume:
type: number
format: double
example: 209.95
exportVolume:
type: number
format: double
example: -1372.384
netVolume:
type: number
format: double
example: -1162.434
additionalProperties: false
Insights.Api.Models.Responses.Transparency.DatasetRows.WeekAheadTotalLoadPerBiddingZoneDatasetRow:
type: object
properties:
dataset:
type: string
nullable: true
example: WATL
documentId:
type: string
nullable: true
example: NGET-EMFIP-WATL-16209423
documentRevisionNumber:
type: integer
format: int32
example: 1
publishTime:
type: string
format: date-time
example: '2023-07-12 05:00:00Z'
forecastDate:
type: string
format: date
example: '2023-07-24'
forecastWeek:
type: integer
format: int32
example: 30
minimumPossible:
type: number
format: double
example: 18034
maximumAvailable:
type: number
format: double
example: 35011
additionalProperties: false
Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedDemand:
type: object
properties:
dataset:
type: string
nullable: true
demand:
type: integer
format: int64
nullable: true
publishTime:
type: string
format: date-time
startTime:
type: string
format: date-time
settlementDate:
type: string
format: date
settlementPeriod:
type: integer
format: int32
boundary:
type: string
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.SystemFrequency:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Misc.DatasetRows.SystemFrequency'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.Transparency.DatasetRows.CostsOfCongestionManagementDatasetRow:
type: object
properties:
dataset:
type: string
nullable: true
example: CCM
documentId:
type: string
nullable: true
example: NGET-EMFIP-CCM-00688999
documentRevisionNumber:
type: integer
format: int32
example: 1
publishTime:
type: string
format: date-time
example: '2023-07-12 05:00:00Z'
businessType:
type: string
nullable: true
example: Congestion costs
year:
type: integer
format: int32
example: 2023
month:
type: string
nullable: true
example: OCT
amount:
type: number
format: double
example: 1.08
additionalProperties: false
Insights.Api.Models.Responses.DemandOutturn.DatasetRows.DemandOutturnTransmission:
type: object
properties:
dataset:
type: string
nullable: true
publishTime:
type: string
format: date-time
startTime:
type: string
format: date-time
settlementDate:
type: string
format: date
settlementPeriod:
type: integer
format: int32
demand:
type: integer
format: int64
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.Transparency.DatasetRows.FeibDatasetRow:
type: object
properties:
dataset:
type: string
nullable: true
example: FEIB
documentId:
type: string
nullable: true
example: NGET-EMFIP-FEIB-00687316
documentRevisionNumber:
type: integer
format: int32
example: 1
publishTime:
type: string
format: date-time
example: '2021-09-21T10:04:24Z'
status:
type: string
nullable: true
example: Intermediate
year:
type: integer
format: int32
example: 2021
month:
type: string
nullable: true
example: JUL
amount:
type: number
format: double
example: 77112420
priceDirection:
type: string
nullable: true
example: Expenditure
additionalProperties: false
Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.IgcpuDatasetRow:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.IgcpuDatasetRow'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.NonBmStorData:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Generation.DatasetRows.NonBmStorData'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.StablePortageLimitData:
type: object
properties:
dataset:
type: string
nullable: true
example: SEL
settlementDate:
type: string
format: date
example: '2022-07-01'
settlementPeriod:
type: integer
format: int32
example: 3
time:
type: string
format: date-time
example: '2022-07-01T13:34:00Z'
level:
type: integer
format: int32
example: 5
nationalGridBmUnit:
type: string
nullable: true
example: ABRBO-1
bmUnit:
type: string
nullable: true
example: T_ABRBO-1
additionalProperties: false
Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityWeekly:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityWeekly'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.RestorationZone.RestorationZoneDemandForecastDatasetRow:
type: object
properties:
dataset:
type: string
nullable: true
example: RZDF
submissionDateTime:
type: string
format: date-time
example: '2025-01-01T07:01:07'
publishTime:
type: string
format: date-time
example: '2025-01-01T00:00:10'
settlementDate:
type: string
format: date
example: '2025-01-02'
region:
type: string
nullable: true
example: North Scotland
gspGroupId:
type: string
nullable: true
example: _A
forecastDemand60:
type: integer
format: int32
example: 1234
forecastDemand100:
type: integer
format: int32
example: 12345
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryPeriodMinData
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryPeriodMinData'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.ForecastMargin.DatasetRows.ForecastMarginWeekly:
type: object
properties:
dataset:
type: string
nullable: true
publishTime:
type: string
format: date-time
week:
type: integer
format: int32
year:
type: integer
format: int32
margin:
type: integer
format: int64
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.TemperatureData:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Misc.DatasetRows.TemperatureData'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.Misc.DatasetRows.SystemFrequency:
type: object
properties:
dataset:
type: string
nullable: true
measurementTime:
type: string
format: date-time
frequency:
type: number
format: double
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.BalancingServicesVolumeData
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.DatasetRows.BalancingServicesVolumeData'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByFuelTypeDaily:
type: object
properties:
dataset:
type: string
nullable: true
fuelType:
type: string
nullable: true
publishTime:
type: string
format: date-time
nullable: true
systemZone:
type: string
nullable: true
forecastDate:
type: string
format: date
forecastDateTimezone:
type: string
nullable: true
readOnly: true
outputUsable:
type: integer
format: int64
nullable: true
biddingZone:
type: string
nullable: true
interconnectorName:
type: string
nullable: true
interconnector:
type: boolean
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByFuelTypeWeekly
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByFuelTypeWeekly'
nullable: true
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.DatasetRows.NetBalancingServicesAdjustmentData
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.DatasetRows.NetBalancingServicesAdjustmentData'
nullable: true
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedImbalance
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedImbalance'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.CbsDatasetRow:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.CbsDatasetRow'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastTransmissionDayAhead:
type: object
properties:
dataset:
type: string
nullable: true
demand:
type: integer
format: int64
nullable: true
publishTime:
type: string
format: date-time
startTime:
type: string
format: date-time
settlementDate:
type: string
format: date
settlementPeriod:
type: integer
format: int32
boundary:
type: string
nullable: true
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastNationalDayAhead
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastNationalDayAhead'
nullable: true
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.LossOfLoadProbabilityDeratedMarginData
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Misc.DatasetRows.LossOfLoadProbabilityDeratedMarginData'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryPeriodMinData:
type: object
properties:
dataset:
type: string
nullable: true
example: MZT
settlementDate:
type: string
format: date
example: '2022-07-25'
settlementPeriod:
type: integer
format: int32
example: 3
time:
type: string
format: date-time
example: '2022-07-25T09:34:00Z'
periodMin:
type: integer
format: int32
example: 360
nationalGridBmUnit:
type: string
nullable: true
example: ABRBO-1
bmUnit:
type: string
nullable: true
example: T_ABRBO-1
additionalProperties: false
Insights.Api.Models.Responses.ForecastSurplus.DatasetRows.ForecastSurplusDaily:
type: object
properties:
dataset:
type: string
nullable: true
publishTime:
type: string
format: date-time
forecastDate:
type: string
format: date
surplus:
type: integer
format: int64
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityDaily:
type: object
properties:
dataset:
type: string
nullable: true
publishTime:
type: string
format: date-time
nullable: true
systemZone:
type: string
nullable: true
forecastDate:
type: string
format: date
forecastDateTimezone:
type: string
nullable: true
readOnly: true
outputUsable:
type: integer
format: int64
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryPeriodMaxData:
type: object
properties:
dataset:
type: string
nullable: true
example: MDP
settlementDate:
type: string
format: date
example: '2022-07-25'
settlementPeriod:
type: integer
format: int32
example: 3
time:
type: string
format: date-time
example: '2022-07-25T09:34:00Z'
periodMax:
type: integer
format: int32
example: 360
nationalGridBmUnit:
type: string
nullable: true
example: ABRBO-1
bmUnit:
type: string
nullable: true
example: T_ABRBO-1
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedGeneration
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedGeneration'
nullable: true
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.DayAheadAggregatedGenerationDatasetRow
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.DayAheadAggregatedGenerationDatasetRow'
nullable: true
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByBmUnitWeekly
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByBmUnitWeekly'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.Balancing.DatasetRows.CreditDefaultNoticeDatasetResponse:
type: object
properties:
dataset:
type: string
nullable: true
example: CDN
publishTime:
type: string
format: date-time
nullable: true
example: 2022-09-20T00:00Z
bscPartyId:
type: string
nullable: true
example: INVE
creditDefaultLevel:
type: integer
format: int32
example: 1
enteredDefaultSettlementDate:
type: string
format: date
example: '2022-06-25'
enteredDefaultSettlementPeriod:
type: integer
format: int32
example: 3
clearedDefaultSettlementDate:
type: string
format: date
nullable: true
example: '2022-07-02'
clearedDefaultSettlementPeriod:
type: integer
format: int32
nullable: true
example: 29
clearedDefaultText:
type: string
nullable: true
example: Credit Cover Percentage greater than or equal to 90% of Credit Limit (Level 2 Default)
additionalProperties: false
Insights.Api.Models.Responses.Misc.DatasetRows.LossOfLoadProbabilityDeratedMarginData:
type: object
properties:
dataset:
type: string
nullable: true
example: LOLPDRM
publishTime:
type: string
format: date-time
example: '2023-01-31 17:39:15Z'
publishingPeriodCommencingTime:
type: string
format: date-time
example: 2023-01-31 17:30Z
startTime:
type: string
format: date-time
example: 2023-01-31 18:30Z
settlementDate:
type: string
format: date
example: '2023-01-31'
settlementPeriod:
type: integer
format: int32
example: 38
lossOfLoadProbability:
type: number
format: double
nullable: true
example: 0
deratedMargin:
type: number
format: double
nullable: true
example: 12570.207
additionalProperties: false
Insights.Api.Models.Responses.Transparency.DatasetRows.ActualGenerationOutputPerGenerationUnitDatasetResponse:
type: object
properties:
dataset:
type: string
nullable: true
example: B1610
psrType:
type: string
nullable: true
example: Generation
bmUnit:
type: string
nullable: true
example: T_CNQPS-1
nationalGridBmUnitId:
type: string
nullable: true
example: CNQPS-1
settlementDate:
type: string
format: date
example: '2022-08-12'
settlementPeriod:
type: integer
format: int32
example: 10
halfHourEndTime:
type: string
format: date-time
example: '2022-08-12T04:00:00Z'
quantity:
type: number
format: double
example: 116.109
additionalProperties: false
Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastNationalWeekly:
type: object
properties:
dataset:
type: string
nullable: true
publishTime:
type: string
format: date-time
year:
type: integer
format: int32
week:
type: integer
format: int32
demand:
type: integer
format: int64
nullable: true
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandOutturn.DatasetRows.DemandOutturnNational
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DemandOutturn.DatasetRows.DemandOutturnNational'
nullable: true
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.ActualAggregatedGenerationPerTypeDatasetRow
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.ActualAggregatedGenerationPerTypeDatasetRow'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastTransmissionDaily:
type: object
properties:
dataset:
type: string
nullable: true
publishTime:
type: string
format: date-time
forecastDate:
type: string
format: date
demand:
type: integer
format: int64
nullable: true
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.YearAheadForecastMarginDatasetRow
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.YearAheadForecastMarginDatasetRow'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.TudmDatasetRow:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Misc.DatasetRows.TudmDatasetRow'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.Balancing.DatasetRows.MarketIndexDatasetResponse:
type: object
properties:
dataset:
type: string
nullable: true
example: MID
startTime:
type: string
format: date-time
example: '2022-09-26T13:00:00Z'
dataProvider:
type: string
nullable: true
example: N2EXMIDP
settlementDate:
type: string
format: date
example: '2022-09-26'
settlementPeriod:
type: integer
format: int32
example: 3
price:
type: number
format: double
example: 678.12
volume:
type: number
format: double
example: 678.123
additionalProperties: false
Insights.Api.Models.Responses.Transparency.DatasetRows.IgcaDatasetRow:
type: object
properties:
dataset:
type: string
nullable: true
example: IGCA
documentId:
type: string
nullable: true
example: NGET-EMFIP-IGCA-00687002
documentRevisionNumber:
type: integer
format: int32
example: 1
publishTime:
type: string
format: date-time
example: '2022-04-21T13:25:52Z'
businessType:
type: string
nullable: true
example: Installed generation
psrType:
type: string
nullable: true
example: Hydro Pumped Storage
year:
type: integer
format: int32
example: 2022
quantity:
type: number
format: double
example: 1928
additionalProperties: false
Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.FeibDatasetRow:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.FeibDatasetRow'
nullable: true
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.DeliveryLimitMaxData
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.DeliveryLimitMaxData'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.Reference.DatasetMetadataLatestRow:
type: object
properties:
dataset:
type: string
nullable: true
lastUpdated:
type: string
format: date-time
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.IndicatedForecast.DatasetRows.IndicatedImbalance:
type: object
properties:
dataset:
type: string
nullable: true
imbalance:
type: integer
format: int64
nullable: true
publishTime:
type: string
format: date-time
startTime:
type: string
format: date-time
settlementDate:
type: string
format: date
settlementPeriod:
type: integer
format: int32
boundary:
type: string
nullable: true
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.PhysicalNotificationData
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Physical.DatasetRows.PhysicalNotificationData'
nullable: true
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.WeekAheadTotalLoadPerBiddingZoneDatasetRow
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.WeekAheadTotalLoadPerBiddingZoneDatasetRow'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.RestorationZone.RestorationZoneDemandRestoredDatasetRow:
type: object
properties:
dataset:
type: string
nullable: true
example: RZDR
submissionDateTime:
type: string
format: date-time
example: '2025-01-01T07:01:07'
publishTime:
type: string
format: date-time
example: '2025-01-01T00:00:10'
region:
type: string
nullable: true
example: North Scotland
gspGroupId:
type: string
nullable: true
example: _A
restoredDemand:
type: integer
format: int32
example: 1234
additionalProperties: false
Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastNationalDayAhead:
type: object
properties:
dataset:
type: string
nullable: true
demand:
type: integer
format: int64
nullable: true
publishTime:
type: string
format: date-time
startTime:
type: string
format: date-time
settlementDate:
type: string
format: date
settlementPeriod:
type: integer
format: int32
boundary:
type: string
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityByBmUnitWeekly:
type: object
properties:
dataset:
type: string
nullable: true
fuelType:
type: string
nullable: true
example: CCGT
nationalGridBmUnit:
type: string
nullable: true
example: CARR-1
bmUnit:
type: string
nullable: true
example: T_CARR-1
publishTime:
type: string
format: date-time
nullable: true
example: '2022-08-10T15:00:00Z'
week:
type: integer
format: int32
nullable: true
example: 34
year:
type: integer
format: int32
nullable: true
example: 2022
outputUsable:
type: integer
format: int64
nullable: true
example: 442
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastNationalDaily
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastNationalDaily'
nullable: true
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.ActualGenerationWindSolarDatasetRow
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.ActualGenerationWindSolarDatasetRow'
nullable: true
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryVolumeMaxData
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Balancing.Dynamic.DatasetRows.DeliveryVolumeMaxData'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.Transparency.Remit.DatasetRows.OutageProfileData:
type: object
properties:
startTime:
type: string
format: date-time
endTime:
type: string
format: date-time
capacity:
type: number
format: double
additionalProperties: false
Insights.Api.Models.Responses.Transparency.DatasetRows.BebDatasetRow:
type: object
properties:
dataset:
type: string
nullable: true
example: BEB
documentId:
type: string
nullable: true
example: NGET-EMFIP-BEB-00688983
documentRevisionNumber:
type: integer
format: int32
example: 1
publishTime:
type: string
format: date-time
example: '2023-08-22T07:43:04Z'
bidId:
type: string
nullable: true
example: NGET-EMFIP-BEB-TS-36758603
flowDirection:
type: string
nullable: true
example: Up
quantity:
type: number
format: double
example: 1140
energyPrice:
type: number
format: double
example: 150
startTime:
type: string
format: date-time
example: '2023-08-22T07:43:04Z'
settlementDate:
type: string
format: date
example: '2023-08-23'
settlementPeriod:
type: integer
format: int32
example: 1
additionalProperties: false
Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AugmentedOutturnData:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Generation.DatasetRows.AugmentedOutturnData'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.Balancing.DatasetRows.BidOfferDatasetResponse:
type: object
properties:
dataset:
type: string
nullable: true
example: BOD
settlementDate:
type: string
format: date
example: '2022-07-25'
settlementPeriod:
type: integer
format: int32
example: 3
timeFrom:
type: string
format: date-time
example: '2022-07-01T13:34:00Z'
levelFrom:
type: integer
format: int32
example: 5
timeTo:
type: string
format: date-time
example: '2022-07-01T13:34:00Z'
levelTo:
type: integer
format: int32
example: 46
pairId:
type: integer
format: int32
example: 1
offer:
type: number
format: double
example: -71.5
bid:
type: number
format: double
example: 668.67
nationalGridBmUnit:
type: string
nullable: true
example: ABRBO-1
bmUnit:
type: string
nullable: true
example: T_ABRBO-1
additionalProperties: false
Insights.Api.Models.Responses.Transparency.DatasetRows.PpbrDatasetRow:
type: object
properties:
dataset:
type: string
nullable: true
example: PPBR
documentId:
type: string
nullable: true
example: NGET-EMFIP-PPBR-00688983
documentRevisionNumber:
type: integer
format: int32
example: 1
publishTime:
type: string
format: date-time
example: '2023-08-22T07:43:04Z'
psrType:
type: string
nullable: true
example: Generation
marketAgreementType:
type: string
nullable: true
example: Daily
flowDirection:
type: string
nullable: true
example: Up
settlementDate:
type: string
format: date
example: '2023-08-23'
amount:
type: number
format: double
example: 1.2
additionalProperties: false
Insights.Api.Models.Responses.Transparency.DatasetRows.DayAheadGenerationForWindAndSolarDatasetRow:
type: object
properties:
dataset:
type: string
nullable: true
example: DGWS
documentId:
type: string
nullable: true
example: NGET-EMFIP-DGWSINTRADAY-06043339
documentRevisionNumber:
type: integer
format: int32
example: 1
publishTime:
type: string
format: date-time
example: '2023-07-12 05:00:00Z'
processType:
type: string
nullable: true
example: Intraday process
businessType:
type: string
nullable: true
example: Wind generation
psrType:
type: string
nullable: true
example: Wind Offshore
quantity:
type: number
format: double
example: 1829
startTime:
type: string
format: date-time
example: '2023-07-12 06:30:00Z'
settlementDate:
type: string
format: date
example: '2023-07-12'
settlementPeriod:
type: integer
format: int32
example: 16
additionalProperties: false
Insights.Api.Models.Responses.Misc.DatasetRows.TemperatureData:
type: object
properties:
dataset:
type: string
nullable: true
measurementDate:
type: string
format: date
publishTime:
type: string
format: date-time
temperature:
type: number
format: double
nullable: true
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Misc.DatasetRows.DemandControlInstructionDatasetRow
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Misc.DatasetRows.DemandControlInstructionDatasetRow'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.Transparency.DatasetRows.DayAheadAggregatedGenerationDatasetRow:
type: object
properties:
dataset:
type: string
nullable: true
example: DAG
documentId:
type: string
nullable: true
example: NGET-EMFIP-DAG-06244336
documentRevisionNumber:
type: integer
format: int32
example: 1
publishTime:
type: string
format: date-time
example: '2023-07-12 05:00:00Z'
quantity:
type: number
format: double
example: 1804.5
startTime:
type: string
format: date-time
example: '2023-07-12 06:30:00Z'
settlementDate:
type: string
format: date
example: '2023-07-12'
settlementPeriod:
type: integer
format: int32
example: 16
additionalProperties: false
Insights.Api.Models.Responses.Transparency.DatasetRows.IgcpuDatasetRow:
type: object
properties:
dataset:
type: string
nullable: true
example: IGCPU
documentId:
type: string
nullable: true
example: NGET-EMFIP-CONF-00688811
publishTime:
type: string
format: date-time
example: '2022-04-21T13:25:52Z'
effectiveFrom:
type: string
format: date
example: '2023-08-07'
psrType:
type: string
nullable: true
example: Other
registeredResourceEicCode:
type: string
nullable: true
example: 48WVPI-TRAD-BMUI
registeredResourceName:
type: string
nullable: true
example: DBAWO-1
bmUnit:
type: string
nullable: true
example: T_DBAWO-1
voltageLimit:
type: number
format: double
nullable: true
example: 2234.1
installedCapacity:
type: number
format: double
example: 1928.2
additionalProperties: false
Insights.Api.Models.Responses.DemandOutturn.DatasetRows.DemandOutturnNational:
type: object
properties:
dataset:
type: string
nullable: true
publishTime:
type: string
format: date-time
nullable: true
startTime:
type: string
format: date-time
settlementDate:
type: string
format: date
settlementPeriod:
type: integer
format: int32
demand:
type: integer
format: int64
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.Transparency.DatasetRows.CbsDatasetRow:
type: object
properties:
dataset:
type: string
nullable: true
example: CBS
documentId:
type: string
nullable: true
example: NGET-EMFIP-CBS-00879999
documentRevisionNumber:
type: integer
format: int32
example: 1
publishTime:
type: string
format: date-time
example: '2023-10-24T13:09:07Z'
flowDirection:
type: string
nullable: true
example: Up
quantity:
type: number
format: double
example: 12412
timeFrom:
type: string
format: date-time
example: '2023-09-11T14:30:00Z'
timeTo:
type: string
format: date-time
example: '2023-09-11T14:30:00Z'
settlementDate:
type: string
format: date
example: '2023-09-11'
settlementPeriod:
type: integer
format: int32
example: 32
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastTransmissionDaily
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.DemandForecast.DatasetRows.DemandForecastTransmissionDaily'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Reference.DatasetMetadataLatestRow:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Reference.DatasetMetadataLatestRow'
nullable: true
additionalProperties: false
? Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Transparency.DatasetRows.DayAheadGenerationForWindAndSolarDatasetRow
: type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Transparency.DatasetRows.DayAheadGenerationForWindAndSolarDatasetRow'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.Misc.DatasetRows.DemandControlInstructionDatasetRow:
type: object
properties:
dataset:
type: string
nullable: true
example: DCI
mRID:
type: string
nullable: true
example: DCI_202104300853_00000030
revisionNumber:
type: integer
format: int32
example: 1
publishTime:
type: string
format: date-time
nullable: true
example: '2021-04-30T08:53:39Z'
publishingPeriodCommencingTime:
type: string
format: date-time
example: '2021-04-30T08:53:39Z'
affectedDso:
type: string
nullable: true
example: SP(D)
demandControlId:
type: string
nullable: true
example: '00135'
instructionSequence:
type: integer
format: int32
example: 1
demandControlEventFlag:
type: string
example: I
timeFrom:
type: string
format: date-time
example: '2021-04-30T12:45:00Z'
timeTo:
type: string
format: date-time
nullable: true
example: '2021-04-30T13:09:00Z'
volume:
type: number
format: double
example: 68
systemManagementActionFlag:
type: string
nullable: true
example: T
amendmentFlag:
type: string
nullable: true
example: ORI
additionalProperties: false
Insights.Api.Models.Responses.DatasetResponse-1_Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityDaily:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Insights.Api.Models.Responses.Generation.DatasetRows.AvailabilityDaily'
nullable: true
additionalProperties: false
Insights.Api.Models.Responses.ForecastMargin.DatasetRows.ForecastMarginDaily:
type: object
properties:
dataset:
type: string
nullable: true
publishTime:
type: string
format: date-time
forecastDate:
type: string
format: date
margin:
type: integer
format: int64
nullable: true
additionalProperties: false