v1

latestOpenAPI 3.0.42026-07-233182951.4 MB

Demand

Indicative peak demand per day (S0142, ITSDO, FUELHH)

Indicative demand peaks using operational metering data are daily maxima values determined from ITSDO and FUELHH data used to determine and visualise Triad.

Indicative demand peaks using settlement metering data are daily maxima values determined from metered volume data from the S0142_bpi file. These peaks are not used for Triad visualisation as they are always calculated based on the latest run type. Triads for settlement data remain static after the National Grid report posted at the beginning of April after the Triad season has ended.

If no filters are supplied, results default to the latest or current Triad season. To specify a custom filter, you can supplier EITHER a Triad season start year, OR a date range, but not both. If a Triad Season Start year is supplied, data for the Triad season beginning on 1 November of the specified year will be returned. If a date range is supplied, data will be returned for settlement dates within the date range inclusively.

Date parameters must be provided in the exact format yyyy-MM-dd.

get/demand/peak/indicative

Query parameters

data'operational' | 'settlement' required

Example:operational

The type of data. Supports values of 'operational' or 'settlement'.

triadSeasonStartYearinteger

A year indicating the Triad season starting on 1 November of the given year, e.g. 2021.

fromstring date

Example:2021-10-01

The start of the requested date range.

tostring date

Example:2021-10-30

The end of the requested date range.

format'json' | 'xml' | 'csv'

Response data format. Use json/xml to include metadata.

Response

Data retrieved

Example response

{
  "data": [
    {
      "settlementDate": "2021-10-01",
      "settlementPeriod": 3,
      "halfHourEndTime": "2021-10-01T01:00:00Z",
      "demand": 36256,
      "settlementRunType": "II"
    }
  ],
  "metadata": {
    "datasets": [
      "DATASET"
    ]
  }
}