# Elexon

> Follow Great Britain's electricity market with Elexon's Balancing Mechanism Reporting Service (BMRS). See the live generation mix and generation by fuel, interconnector flows, wind and solar output and forecasts; demand, daily peaks and the demand forecasts; imbalance and market index prices, grid frequency and temperature; system warnings and REMIT outage messages; and each Balancing Mechanism unit's notifications and bids. Start workflows on new system warnings and REMIT messages. Everything reads: nothing here changes anything. No account or API key required.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/elexon

## Actions

### Get a REMIT message

Read one REMIT message in full by its id: the unit, how much capacity is unavailable, when, why, and whether the event is still active.

**Inputs**

- Message id (`message_id`, number, required): The message's id, which 'Search REMIT messages' and the trigger return. At least 1.

**Outputs**

- `affected_unit` (text): The unit affected
- `asset_id` (text): The asset's id, often its BM unit
- `available_capacity_mw` (number): What is available during the event, in MW
- `cause` (text): The cause given, if any
- `event_end` (text): When it ends, in UTC
- `event_start` (text): When the event starts, in UTC
- `event_status` (text): Active, Inactive or Dismissed
- `event_type` (text): Such as Production unavailability
- `fuel_type` (text): The unit's fuel, such as Fossil Gas
- `heading` (text): The message's heading
- `id` (number): Elexon's id for this revision of the message
- `message_type` (text): The kind of message, such as UnavailabilitiesOfElectricityFacilities
- `mrid` (text): The message's own id, shared by all its revisions
- `normal_capacity_mw` (number): Its normal capacity, in MW
- `participant_id` (text): The market participant's id
- `published_at` (text): When the participant published it, in UTC
- `related_information` (text): Anything else the participant added
- `revision_number` (number): Which revision this is, 1 for the first
- `unavailability_type` (text): Planned or Unplanned, empty for other messages
- `unavailable_capacity_mw` (number): What is unavailable during the event, in MW

**Example output**

```json
{
  "affected_unit": "SCCL-1",
  "asset_id": "T_SCCL-1",
  "available_capacity_mw": 380.0,
  "cause": "Plant Fault",
  "event_end": "2026-10-20T23:30:00Z",
  "event_start": "2026-10-20T00:00:00Z",
  "event_status": "Inactive",
  "event_type": "Production unavailability",
  "fuel_type": "Fossil Gas",
  "heading": "Generated by Genstar4 from Enegen Power Systems.",
  "id": 926382,
  "message_type": "UnavailabilitiesOfElectricityFacilities",
  "mrid": "23X--140120-SCCN-NGET-RMT-00021456",
  "normal_capacity_mw": 400.0,
  "participant_id": "SALTEND",
  "published_at": "2026-10-20T23:32:22Z",
  "related_information": "",
  "revision_number": 2,
  "unavailability_type": "Unplanned",
  "unavailable_capacity_mw": 20.0
}
```

### Get bid-offer data

Get the prices a BM unit bid to reduce its output and offered to increase it, pair by pair, for each half hour of a time range of up to 7 days.

**Inputs**

- BM unit (`bm_unit`, text, required): The Balancing Mechanism unit. Pick it from the list, or give its Elexon id (T_DRAXX-1) or National Grid id (DRAXX-1). 'List BM units' finds one by name, fuel or company.
- From (`from_time`, date and time): The start of the range. Leave it empty for 24 hours before the end. Up to 7 days can be asked for at a time.
- To (`to_time`, date and time): The end of the range. Leave it empty for now, or 24 hours after the start.

**Outputs**

- `bm_unit` (text): The unit's Elexon id
- `bm_unit_name` (text): The unit's name
- `count` (number): How many pairs there are
- `from_time` (text): The start of the range, in UTC
- `pairs` (list): Every bid-offer pair, oldest first
- `to_time` (text): The end of the range, in UTC

**Example output**

```json
{
  "bm_unit": "T_DRAXX-1",
  "bm_unit_name": "T_DRAXX-1",
  "count": 2,
  "from_time": "2026-10-20T12:00:00Z",
  "pairs": [
    {
      "bid_price": -170.0,
      "level_from_mw": -660,
      "level_to_mw": -660,
      "offer_price": 189.95,
      "pair_id": -2,
      "settlement_date": "2026-10-20",
      "settlement_period": 26,
      "time_from": "2026-10-20T11:30:00Z",
      "time_to": "2026-10-20T12:00:00Z"
    },
    {
      "bid_price": 50.0,
      "level_from_mw": -445,
      "level_to_mw": -445,
      "offer_price": 189.95,
      "pair_id": -1,
      "settlement_date": "2026-10-20",
      "settlement_period": 26,
      "time_from": "2026-10-20T11:30:00Z",
      "time_to": "2026-10-20T12:00:00Z"
    }
  ],
  "to_time": "2026-10-20T12:30:00Z"
}
```

### Get daily peak demand

Get each day's peak transmission demand and the half hour it came in, for up to a year. Use it to watch for the winter peaks that set Triad charges.

**Inputs**

- From (`from_date`, date): The first day. Leave both dates empty for the last seven days.
- To (`to_date`, date): The last day. Leave it empty for up to today.

**Outputs**

- `count` (number): How many days there are
- `days` (list): One row per day, oldest first
- `from_date` (text): The first day
- `highest_date` (text): The day it came on
- `highest_demand_mw` (number): The highest of the peaks, in MW
- `to_date` (text): The last day

**Example output**

```json
{
  "count": 3,
  "days": [
    {
      "settlement_date": "2026-10-15",
      "settlement_period": 38,
      "start_time": "2026-10-15T17:30:00Z",
      "transmission_demand_mw": 37106
    },
    {
      "settlement_date": "2026-10-16",
      "settlement_period": 39,
      "start_time": "2026-10-16T18:00:00Z",
      "transmission_demand_mw": 35524
    },
    {
      "settlement_date": "2026-10-17",
      "settlement_period": 38,
      "start_time": "2026-10-17T17:30:00Z",
      "transmission_demand_mw": 35233
    }
  ],
  "from_date": "2026-10-15",
  "highest_date": "2026-10-20",
  "highest_demand_mw": 40598,
  "to_date": "2026-10-20"
}
```

### Get demand outturn

Get national and transmission system demand for each half hour of up to 28 settlement dates, as metered, with the peak and the average.

**Inputs**

- From (`from_date`, date): The first UK settlement date. Leave it empty for today. Up to 28 days can be asked for at a time.
- To (`to_date`, date): The last settlement date. Leave it empty for up to today.

**Outputs**

- `average_national_demand_mw` (number): Average national demand, in MW
- `count` (number): How many half hours there are
- `demand` (list): Every half hour, oldest first
- `from_date` (text): The first settlement date
- `peak_national_demand_mw` (number): Highest national demand, in MW
- `peak_time` (text): When that peak was, in UTC
- `to_date` (text): The last settlement date

**Example output**

```json
{
  "average_national_demand_mw": 30095.12,
  "count": 2,
  "demand": [
    {
      "national_demand_mw": 23800,
      "settlement_date": "2026-10-20",
      "settlement_period": 1,
      "start_time": "2026-10-19T23:00:00Z",
      "transmission_demand_mw": 27723
    },
    {
      "national_demand_mw": 23536,
      "settlement_date": "2026-10-20",
      "settlement_period": 2,
      "start_time": "2026-10-19T23:30:00Z",
      "transmission_demand_mw": 27589
    }
  ],
  "from_date": "2026-10-20",
  "peak_national_demand_mw": 37038,
  "peak_time": "2026-10-20T17:30:00Z",
  "to_date": "2026-10-20"
}
```

### Get generation by fuel type

Get generation by fuel type for a range of settlement dates, half-hourly (up to 7 days) or every five minutes (one day), with each fuel's average and peak. Narrow it to the fuels you care about, such as wind and nuclear.

**Inputs**

- From (`from_date`, date): The first UK settlement date. Leave it empty for today. Up to 7 days can be asked for at a time.
- To (`to_date`, date): The last settlement date. Leave it empty for up to today.
- Fuel types (`fuel_types`, list): Only these fuels. Leave it empty for every fuel and interconnector.
- Resolution (`resolution`, text): Half-hourly averages, or a reading every five minutes (one day at a time). One of: `half_hourly` (Half-hourly), `five_minute` (Every five minutes). Default: `half_hourly`.

**Outputs**

- `count` (number): How many readings there are
- `from_date` (text): The first settlement date
- `fuel_summary` (list): Each fuel's average and peak, largest first
- `generation` (list): Every reading, oldest first
- `resolution` (text): half_hourly or five_minute
- `to_date` (text): The last settlement date

**Example output**

```json
{
  "count": 2,
  "from_date": "2026-10-20",
  "fuel_summary": [
    {
      "average_mw": 11672.38,
      "fuel_name": "Wind",
      "fuel_type": "WIND",
      "latest_mw": 10648,
      "peak_mw": 13687
    },
    {
      "average_mw": 4931.81,
      "fuel_name": "Nuclear",
      "fuel_type": "NUCLEAR",
      "latest_mw": 4934,
      "peak_mw": 4944
    }
  ],
  "generation": [
    {
      "fuel_name": "Nuclear",
      "fuel_type": "NUCLEAR",
      "generation_mw": 4927,
      "settlement_date": "2026-10-20",
      "settlement_period": 1,
      "start_time": "2026-10-19T23:00:00Z"
    },
    {
      "fuel_name": "Wind",
      "fuel_type": "WIND",
      "generation_mw": 9658,
      "settlement_date": "2026-10-20",
      "settlement_period": 1,
      "start_time": "2026-10-19T23:00:00Z"
    }
  ],
  "resolution": "half_hourly",
  "to_date": "2026-10-20"
}
```

### Get interconnector flows

Get the half-hourly flow on each interconnector between Great Britain and France, Belgium, the Netherlands, Norway, Denmark and Ireland: positive is an import, negative an export, with each link's average and net direction.

**Inputs**

- From (`from_date`, date): The first UK settlement date. Leave it empty for today. Up to 7 days can be asked for at a time.
- To (`to_date`, date): The last settlement date. Leave it empty for up to today.
- Interconnectors (`interconnectors`, list): Only these links. Leave it empty for all of them.

**Outputs**

- `count` (number): How many flows there are
- `flows` (list): Every half-hourly flow, oldest first
- `from_date` (text): The first settlement date
- `interconnector_summary` (list): Each link's average
- `to_date` (text): The last settlement date

**Example output**

```json
{
  "count": 2,
  "flows": [
    {
      "country": "France",
      "direction": "export",
      "flow_mw": -822,
      "interconnector": "France(IFA)",
      "interconnector_id": "INTFR",
      "settlement_date": "2026-10-20",
      "settlement_period": 1,
      "start_time": "2026-10-19T23:00:00Z"
    },
    {
      "country": "Norway",
      "direction": "import",
      "flow_mw": 1400,
      "interconnector": "North Sea Link (INTNSL)",
      "interconnector_id": "INTNSL",
      "settlement_date": "2026-10-20",
      "settlement_period": 1,
      "start_time": "2026-10-19T23:00:00Z"
    }
  ],
  "from_date": "2026-10-20",
  "interconnector_summary": [
    {
      "average_mw": -70.0,
      "interconnector": "France(IFA)",
      "net_direction": "export"
    },
    {
      "average_mw": 1400.0,
      "interconnector": "North Sea Link (INTNSL)",
      "net_direction": "import"
    }
  ],
  "to_date": "2026-10-20"
}
```

### Get market index prices

Get the wholesale market index price and traded volume for each half hour from EPEX Spot and Nord Pool, with the volume-weighted average over the range.

**Inputs**

- From (`from_time`, date and time): The start of the range. Leave it empty for 24 hours before the end. Up to 7 days can be asked for at a time.
- To (`to_time`, date and time): The end of the range. Leave it empty for now, or 24 hours after the start.
- Exchange (`provider`, text): Only one exchange. Leave it empty for both; Nord Pool often reports no trades. One of: `APXMIDP` (EPEX Spot (APX)), `N2EXMIDP` (Nord Pool (N2EX)).

**Outputs**

- `count` (number): How many prices there are
- `from_time` (text): The start of the range, in UTC
- `prices` (list): Every half hour and exchange, oldest first
- `to_time` (text): The end of the range, in UTC
- `total_volume_mwh` (number): The volume traded over the range, in MWh
- `volume_weighted_price` (number): The average price weighted by volume, in £ per MWh

**Example output**

```json
{
  "count": 2,
  "from_time": "2026-10-20T00:00:00Z",
  "prices": [
    {
      "price": 138.18,
      "provider": "APXMIDP",
      "provider_name": "EPEX Spot (APX)",
      "settlement_date": "2026-10-20",
      "settlement_period": 3,
      "start_time": "2026-10-20T00:00:00Z",
      "volume_mwh": 2308.95
    },
    {
      "price": 139.03,
      "provider": "APXMIDP",
      "provider_name": "EPEX Spot (APX)",
      "settlement_date": "2026-10-20",
      "settlement_period": 4,
      "start_time": "2026-10-20T00:30:00Z",
      "volume_mwh": 2157.1
    }
  ],
  "to_time": "2026-10-20T01:00:00Z",
  "total_volume_mwh": 7010.75,
  "volume_weighted_price": 139.99
}
```

### Get physical notifications

Get what a BM unit told the control room it would generate or consume (its physical notification) and its export and import limits, for a time range of up to 7 days.

**Inputs**

- BM unit (`bm_unit`, text, required): The Balancing Mechanism unit. Pick it from the list, or give its Elexon id (T_DRAXX-1) or National Grid id (DRAXX-1). 'List BM units' finds one by name, fuel or company.
- From (`from_time`, date and time): The start of the range. Leave it empty for 24 hours before the end. Up to 7 days can be asked for at a time.
- To (`to_time`, date and time): The end of the range. Leave it empty for now, or 24 hours after the start.
- What to include (`datasets`, list): Which of the four to include. Leave it empty for all of them. One or more of: `PN` (Physical notification), `QPN` (Quiescent physical notification), `MELS` (Maximum export limit), `MILS` (Maximum import limit).

**Outputs**

- `bm_unit` (text): The unit's Elexon id
- `bm_unit_name` (text): The unit's name
- `count` (number): How many levels there are
- `from_time` (text): The start of the range, in UTC
- `levels` (list): Every level, oldest first
- `to_time` (text): The end of the range, in UTC

**Example output**

```json
{
  "bm_unit": "T_DRAXX-1",
  "bm_unit_name": "T_DRAXX-1",
  "count": 2,
  "from_time": "2026-10-20T12:00:00Z",
  "levels": [
    {
      "dataset": "MELS",
      "dataset_name": "Maximum export limit",
      "level_from_mw": 645,
      "level_to_mw": 645,
      "settlement_date": "2026-10-20",
      "settlement_period": 26,
      "time_from": "2026-10-20T11:30:00Z",
      "time_to": "2026-10-20T12:00:00Z"
    },
    {
      "dataset": "PN",
      "dataset_name": "Physical notification",
      "level_from_mw": 645,
      "level_to_mw": 645,
      "settlement_date": "2026-10-20",
      "settlement_period": 26,
      "time_from": "2026-10-20T11:30:00Z",
      "time_to": "2026-10-20T12:00:00Z"
    }
  ],
  "to_time": "2026-10-20T12:30:00Z"
}
```

### Get system frequency

Get the grid's frequency every 15 seconds for up to 24 hours, with its lowest, highest and average. It sits near 50 Hz; a dip below 49.8 Hz means generation was lost.

**Inputs**

- From (`from_time`, date and time): The start of the range. Leave it empty for an hour before the end.
- To (`to_time`, date and time): The end of the range, at most 24 hours after the start. Leave it empty for now.

**Outputs**

- `average_hz` (number): The average frequency, in hertz
- `count` (number): How many readings there are
- `from_time` (text): The start of the range, in UTC
- `highest_hz` (number): The highest reading, in hertz
- `highest_time` (text): When it was, in UTC
- `lowest_hz` (number): The lowest reading, in hertz
- `lowest_time` (text): When it was, in UTC
- `readings` (list): Every reading, oldest first
- `to_time` (text): The end of the range, in UTC

**Example output**

```json
{
  "average_hz": 50.08,
  "count": 4,
  "from_time": "2026-10-20T12:00:00Z",
  "highest_hz": 50.112,
  "highest_time": "2026-10-20T12:00:00Z",
  "lowest_hz": 50.062,
  "lowest_time": "2026-10-20T12:00:45Z",
  "readings": [
    {
      "frequency_hz": 50.112,
      "time": "2026-10-20T12:00:00Z"
    },
    {
      "frequency_hz": 50.068,
      "time": "2026-10-20T12:00:15Z"
    },
    {
      "frequency_hz": 50.064,
      "time": "2026-10-20T12:00:30Z"
    },
    {
      "frequency_hz": 50.062,
      "time": "2026-10-20T12:00:45Z"
    }
  ],
  "to_time": "2026-10-20T12:00:45Z"
}
```

### Get system prices

Get the imbalance (system) buy and sell price and the net imbalance volume for every half hour of a settlement date, with the day's average, highest and lowest.

**Inputs**

- Settlement date (`settlement_date`, date): The UK settlement date. Leave it empty for today.

**Outputs**

- `average_price` (number): The day's average sell price, in £ per MWh
- `count` (number): How many periods have prices
- `highest_period` (number): The period it came in
- `highest_price` (number): The highest sell price, in £ per MWh
- `lowest_period` (number): The period it came in
- `lowest_price` (number): The lowest sell price, in £ per MWh
- `prices` (list): One row per settlement period
- `settlement_date` (text): The settlement date

**Example output**

```json
{
  "average_price": 156.11,
  "count": 2,
  "highest_period": 43,
  "highest_price": 235.0,
  "lowest_period": 11,
  "lowest_price": 96.0,
  "prices": [
    {
      "net_imbalance_volume_mwh": -284.49,
      "price_derivation_code": "N",
      "reserve_scarcity_price": 0.0,
      "settlement_date": "2026-10-20",
      "settlement_period": 1,
      "start_time": "2026-10-19T23:00:00Z",
      "system_buy_price": 144.54,
      "system_sell_price": 144.54
    },
    {
      "net_imbalance_volume_mwh": -426.93,
      "price_derivation_code": "N",
      "reserve_scarcity_price": 0.0,
      "settlement_date": "2026-10-20",
      "settlement_period": 2,
      "start_time": "2026-10-19T23:30:00Z",
      "system_buy_price": 139.39,
      "system_sell_price": 139.39
    }
  ],
  "settlement_date": "2026-10-20"
}
```

### Get temperature

Get Great Britain's daily average temperature, as National Grid measures it for demand forecasting, against the normal for the time of year, for up to a year.

**Inputs**

- From (`from_date`, date): The first day. Leave both dates empty for the last week.
- To (`to_date`, date): The last day. Leave it empty for up to today.

**Outputs**

- `average_c` (number): The average over the range, in Celsius
- `count` (number): How many days there are
- `days` (list): One row per day, oldest first
- `from_date` (text): The first day
- `to_date` (text): The last day

**Example output**

```json
{
  "average_c": 10.53,
  "count": 3,
  "days": [
    {
      "date": "2026-10-18",
      "difference_from_normal_c": -1.4,
      "high_reference_c": 13.9,
      "low_reference_c": 9.3,
      "normal_c": 11.7,
      "temperature_c": 10.3
    },
    {
      "date": "2026-10-19",
      "difference_from_normal_c": -1.1,
      "high_reference_c": 13.8,
      "low_reference_c": 9.1,
      "normal_c": 11.6,
      "temperature_c": 10.5
    },
    {
      "date": "2026-10-20",
      "difference_from_normal_c": -0.7,
      "high_reference_c": 13.8,
      "low_reference_c": 9.0,
      "normal_c": 11.5,
      "temperature_c": 10.8
    }
  ],
  "from_date": "2026-10-18",
  "to_date": "2026-10-20"
}
```

### Get the 14-day demand forecast

Get the forecast peak national and transmission demand for each of the next two weeks, from National Grid's latest forecast.

**Inputs**: None.

**Outputs**

- `count` (number): How many days are forecast
- `days` (list): One row per day, soonest first
- `published_at` (text): When the forecast was published, in UTC

**Example output**

```json
{
  "count": 3,
  "days": [
    {
      "forecast_date": "2026-10-23",
      "national_demand_mw": 33690,
      "transmission_demand_mw": 34190
    },
    {
      "forecast_date": "2026-10-24",
      "national_demand_mw": 31240,
      "transmission_demand_mw": 31740
    },
    {
      "forecast_date": "2026-10-25",
      "national_demand_mw": 33180,
      "transmission_demand_mw": 33680
    }
  ],
  "published_at": "2026-10-21T13:45:00Z"
}
```

### Get the current generation mix

See what is generating Great Britain's electricity right now: each fuel's output in MW and its share, over the last five minutes, half hour and 24 hours, including imports through each interconnector. Use it for a live dashboard or to post when wind beats gas.

**Inputs**: None.

**Outputs**

- `count` (number): How many fuels are listed
- `fuels` (list): One row per fuel, largest first
- `generation_mw` (number): Generation in Great Britain now, in MW
- `imports_mw` (number): Imports through interconnectors now, in MW
- `largest_source` (text): The fuel supplying the most now
- `largest_source_percent` (number): Its share now, in percent
- `total_mw` (number): Total supply now, including imports, in MW

**Example output**

```json
{
  "count": 3,
  "fuels": [
    {
      "current_mw": 12248,
      "current_percent": 47.03,
      "fuel_name": "Wind",
      "fuel_type": "WIND",
      "half_hour_mw": 12429,
      "half_hour_percent": 47.91,
      "is_interconnector": false,
      "last_24h_average_mw": 5778.9,
      "last_24h_percent": 36.79
    },
    {
      "current_mw": 4967,
      "current_percent": 19.07,
      "fuel_name": "Nuclear",
      "fuel_type": "NUCLEAR",
      "half_hour_mw": 4959,
      "half_hour_percent": 19.12,
      "is_interconnector": false,
      "last_24h_average_mw": 2422.2,
      "last_24h_percent": 15.42
    },
    {
      "current_mw": 2063,
      "current_percent": 7.92,
      "fuel_name": "Gas (combined cycle)",
      "fuel_type": "CCGT",
      "half_hour_mw": 1953,
      "half_hour_percent": 7.53,
      "is_interconnector": false,
      "last_24h_average_mw": 2900.4,
      "last_24h_percent": 18.46
    }
  ],
  "generation_mw": 22457.0,
  "imports_mw": 3585.0,
  "largest_source": "Wind",
  "largest_source_percent": 47.03,
  "total_mw": 26042.0
}
```

### Get the day-ahead demand forecast

Get National Grid's latest half-hourly forecast of national and transmission demand for the rest of today and tomorrow, with the forecast peak.

**Inputs**: None.

**Outputs**

- `count` (number): How many half hours are forecast
- `forecasts` (list): Every forecast half hour, oldest first
- `peak_national_demand_mw` (number): The forecast national peak, in MW
- `peak_time` (text): When that peak is forecast, in UTC
- `published_at` (text): When the forecast was published, in UTC

**Example output**

```json
{
  "count": 2,
  "forecasts": [
    {
      "national_demand_mw": 22357,
      "settlement_date": "2026-10-22",
      "settlement_period": 12,
      "start_time": "2026-10-22T04:30:00Z",
      "transmission_demand_mw": 25348
    },
    {
      "national_demand_mw": 24546,
      "settlement_date": "2026-10-22",
      "settlement_period": 13,
      "start_time": "2026-10-22T05:00:00Z",
      "transmission_demand_mw": 26487
    }
  ],
  "peak_national_demand_mw": 36800,
  "peak_time": "2026-10-22T18:00:00Z",
  "published_at": "2026-10-22T04:16:00Z"
}
```

### Get the wind and solar forecast

Get the forecast of solar, onshore wind and offshore wind output for each half hour, day ahead or intraday. Leave the times empty for the next 24 hours.

**Inputs**

- From (`from_time`, date and time): The start of the range. Leave it empty for now.
- To (`to_time`, date and time): The end of the range. Leave it empty for 24 hours after the start.
- Forecast (`forecast_type`, text): Which forecast: the day-ahead one, or a later intraday one. One of: `day_ahead` (Day ahead), `intraday_process` (Intraday process), `intraday_total` (Intraday total), `all` (All of them). Default: `day_ahead`.

**Outputs**

- `count` (number): How many forecast values there are
- `forecast_type` (text): The forecast asked for
- `forecasts` (list): Every half hour and source, oldest first
- `from_time` (text): The start of the range, in UTC
- `to_time` (text): The end of the range, in UTC

**Example output**

```json
{
  "count": 3,
  "forecast_type": "day_ahead",
  "forecasts": [
    {
      "forecast_mw": 7207.0,
      "forecast_type": "Day ahead",
      "published_at": "2026-10-21T16:45:03Z",
      "settlement_date": "2026-10-22",
      "settlement_period": 27,
      "source": "Solar",
      "start_time": "2026-10-22T12:00:00Z"
    },
    {
      "forecast_mw": 9822.0,
      "forecast_type": "Day ahead",
      "published_at": "2026-10-21T16:45:03Z",
      "settlement_date": "2026-10-22",
      "settlement_period": 27,
      "source": "Wind Offshore",
      "start_time": "2026-10-22T12:00:00Z"
    },
    {
      "forecast_mw": 4626.0,
      "forecast_type": "Day ahead",
      "published_at": "2026-10-21T16:45:03Z",
      "settlement_date": "2026-10-22",
      "settlement_period": 27,
      "source": "Wind Onshore",
      "start_time": "2026-10-22T12:00:00Z"
    }
  ],
  "from_time": "2026-10-22T12:00:00Z",
  "to_time": "2026-10-22T12:30:00Z"
}
```

### Get the wind generation forecast

Get National Grid's latest forecast of metered wind generation for the next day and a half, hour by hour, with its peak. It is updated up to eight times a day.

**Inputs**: None.

**Outputs**

- `count` (number): How many forecast values there are
- `forecasts` (list): Every forecast hour, oldest first
- `peak_mw` (number): The highest forecast output, in MW
- `peak_time` (text): When that peak is forecast, in UTC
- `published_at` (text): When the forecast was published, in UTC

**Example output**

```json
{
  "count": 3,
  "forecasts": [
    {
      "forecast_mw": 15609,
      "settlement_date": "2026-10-21",
      "settlement_period": 43,
      "start_time": "2026-10-21T20:00:00Z"
    },
    {
      "forecast_mw": 15627,
      "settlement_date": "2026-10-21",
      "settlement_period": 45,
      "start_time": "2026-10-21T21:00:00Z"
    },
    {
      "forecast_mw": 15233,
      "settlement_date": "2026-10-21",
      "settlement_period": 47,
      "start_time": "2026-10-21T22:00:00Z"
    }
  ],
  "peak_mw": 21188,
  "peak_time": "2026-10-24T12:00:00Z",
  "published_at": "2026-10-22T03:30:00Z"
}
```

### Get wind and solar generation

Get actual or estimated solar, onshore wind and offshore wind output for each half hour of a time range, including the embedded solar and wind that the fuel-type figures leave out.

**Inputs**

- From (`from_time`, date and time): The start of the range. Leave it empty for 24 hours before the end. Up to 7 days can be asked for at a time.
- To (`to_time`, date and time): The end of the range. Leave it empty for now, or 24 hours after the start.

**Outputs**

- `count` (number): How many readings there are
- `from_time` (text): The start of the range, in UTC
- `generation` (list): Every half hour and source, oldest first
- `source_summary` (list): Each source's average and peak
- `to_time` (text): The end of the range, in UTC

**Example output**

```json
{
  "count": 3,
  "from_time": "2026-10-20T12:00:00Z",
  "generation": [
    {
      "generation_mw": 2811.0,
      "settlement_date": "2026-10-20",
      "settlement_period": 27,
      "source": "Solar",
      "start_time": "2026-10-20T12:00:00Z"
    },
    {
      "generation_mw": 8785.0,
      "settlement_date": "2026-10-20",
      "settlement_period": 27,
      "source": "Wind Offshore",
      "start_time": "2026-10-20T12:00:00Z"
    },
    {
      "generation_mw": 5568.0,
      "settlement_date": "2026-10-20",
      "settlement_period": 27,
      "source": "Wind Onshore",
      "start_time": "2026-10-20T12:00:00Z"
    }
  ],
  "source_summary": [
    {
      "average_mw": 2729.5,
      "peak_mw": 2811.0,
      "source": "Solar"
    },
    {
      "average_mw": 8723.5,
      "peak_mw": 8785.0,
      "source": "Wind Offshore"
    },
    {
      "average_mw": 5512.5,
      "peak_mw": 5568.0,
      "source": "Wind Onshore"
    }
  ],
  "to_time": "2026-10-20T12:30:00Z"
}
```

### List BM units

List the Balancing Mechanism units Elexon registers (power stations, wind farms, batteries, interconnector users), narrowed by fuel, company or name, with each one's ids and capacity.

**Inputs**

- Fuel types (`fuel_types`, list): Only units of these fuels. Leave it empty for every unit.
- Company (`lead_party`, text): Only units this company runs: part of its name, or its id.
- Name or id contains (`name_contains`, text): Only units whose name or id contains this text.
- How many to return (`limit`, number): How many units to return at most, by id. Defaults to 50. From 1 to 3500. Default: `50`.

**Outputs**

- `count` (number): How many units are returned
- `matched_count` (number): How many matched in all
- `units` (list): The units, by id

**Example output**

```json
{
  "count": 2,
  "matched_count": 9,
  "units": [
    {
      "bm_unit": "T_DRAXX-1",
      "demand_capacity_mw": -25.514,
      "fuel_type": "BIOMASS",
      "generation_capacity_mw": 665.248,
      "gsp_group": "",
      "lead_party": "Drax Power Ltd",
      "lead_party_id": "DRAX",
      "name": "T_DRAXX-1",
      "national_grid_bm_unit": "DRAXX-1",
      "unit_type": "T"
    },
    {
      "bm_unit": "T_DRAXX-10G",
      "demand_capacity_mw": -1.196,
      "fuel_type": "OCGT",
      "generation_capacity_mw": 33.152,
      "gsp_group": "",
      "lead_party": "Drax Power Ltd",
      "lead_party_id": "DRAX",
      "name": "T_DRAXX-10G",
      "national_grid_bm_unit": "DRAXX-10G",
      "unit_type": "T"
    }
  ]
}
```

### List system warnings

List the warnings the electricity control room published, such as electricity margin notices, demand control alerts, IT outages and SO-SO trades, with their full text.

**Inputs**

- From (`from_time`, date and time): The start of the range. Leave it empty for a week before the end.
- To (`to_time`, date and time): The end of the range, at most a year after the start. Leave it empty for now.
- Warning type (`warning_type`, text): Only this kind of warning. Leave it empty for every kind.

**Outputs**

- `count` (number): How many warnings there are
- `from_time` (text): The start of the range, in UTC
- `to_time` (text): The end of the range, in UTC
- `warning_type` (text): The kind asked for, empty for every kind
- `warnings` (list): The warnings, oldest first

**Example output**

```json
{
  "count": 1,
  "from_time": "2026-10-21T00:00:00Z",
  "to_time": "2026-10-22T00:00:00Z",
  "warning_type": "",
  "warnings": [
    {
      "id": "18cb0e160a43162c",
      "published_at": "2026-10-21T12:17:00Z",
      "text": "NATIONAL ENERGY SYSTEM OPERATOR NOTIFICATION of excess energy prices used for settlement outside of BALIT for SO to SO Transactions\nover the National Grid/RTE  Interconnector.\n\nPrices cover 23:00Hrs Today to 05:00Hrs Tomorrow (UK local time) and are in Euro/MWh.\nFrom RTE: Offer 350.00; Bid 0.00 From NESO: Offer 701.21; Bid -210.36\n\nPrices cover 05:00Hrs Tomorrow to 19:00Hrs Tomorrow (UK local time",
      "warning_type": "SO-SO TRADES"
    }
  ]
}
```

### Search REMIT messages

Find REMIT messages, the outage and capacity notices generators publish under EU market rules, by when they were published, participant, asset, fuel and whether the outage was planned. Each comes back in full, newest first.

**Inputs**

- Published from (`from_time`, date and time): The start of the range. Leave it empty for 24 hours before the end. At most 7 days.
- Published to (`to_time`, date and time): The end of the range. Leave it empty for now.
- Participant (`participant`, text): Only messages from this market participant.
- Asset (`asset`, text): Only messages about this asset, often a BM unit id.
- Fuel type (`fuel_type`, text): Only messages about units of this fuel.
- Planned or unplanned (`unavailability_type`, text): Only planned or only unplanned outages. Leave it empty for both.
- How many to return (`limit`, number): How many messages to return at most, newest first. Defaults to 25. From 1 to 200. Default: `25`.

**Outputs**

- `count` (number): How many messages are returned
- `from_time` (text): The start of the range, in UTC
- `matched_count` (number): How many matched in all
- `messages` (list): The messages, newest first
- `to_time` (text): The end of the range, in UTC

**Example output**

```json
{
  "count": 2,
  "from_time": "2026-10-20T00:00:00Z",
  "matched_count": 75,
  "messages": [
    {
      "affected_unit": "SCCL-1",
      "asset_id": "T_SCCL-1",
      "available_capacity_mw": 380.0,
      "cause": "Plant Fault",
      "event_end": "2026-10-20T23:30:00Z",
      "event_start": "2026-10-20T00:00:00Z",
      "event_status": "Inactive",
      "event_type": "Production unavailability",
      "fuel_type": "Fossil Gas",
      "heading": "Generated by Genstar4 from Enegen Power Systems.",
      "id": 926382,
      "message_type": "UnavailabilitiesOfElectricityFacilities",
      "mrid": "23X--140120-SCCN-NGET-RMT-00021456",
      "normal_capacity_mw": 400.0,
      "participant_id": "SALTEND",
      "published_at": "2026-10-20T23:32:22Z",
      "related_information": "",
      "revision_number": 2,
      "unavailability_type": "Unplanned",
      "unavailable_capacity_mw": 20.0
    },
    {
      "affected_unit": "SHOS-1",
      "asset_id": "E_SHOS-1",
      "available_capacity_mw": 0.0,
      "cause": "Commissioning",
      "event_end": "2026-10-21T03:00:00Z",
      "event_start": "2026-10-21T02:30:00Z",
      "event_status": "Dismissed",
      "event_type": "Production unavailability",
      "fuel_type": "Fossil Gas",
      "heading": "REMIT Information",
      "id": 926369,
      "message_type": "UnavailabilitiesOfElectricityFacilities",
      "mrid": "48X000000000283J-NGET-RMT-00053667",
      "normal_capacity_mw": 460.0,
      "participant_id": "SPGEN01",
      "published_at": "2026-10-20T21:27:07Z",
      "related_information": "Event automatically withdrawn..",
      "revision_number": 2,
      "unavailability_type": "Unplanned",
      "unavailable_capacity_mw": 460.0
    }
  ],
  "to_time": "2026-10-21T00:00:00Z"
}
```
