Elexon

App · 20 actions

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.

Actions

ActionWhat it does
Get a REMIT messageRead one REMIT message in full by its id: the unit, how much capacity is unavailable, when, why, and whether the event is still active.
Get bid-offer dataGet 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.
Get daily peak demandGet each day's peak transmission demand and the half hour it came in, for up to a year.
Get demand outturnGet national and transmission system demand for each half hour of up to 28 settlement dates, as metered, with the peak and the average.
Get generation by fuel typeGet 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.
Get interconnector flowsGet 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.
Get market index pricesGet 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.
Get physical notificationsGet 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.
Get system frequencyGet the grid's frequency every 15 seconds for up to 24 hours, with its lowest, highest and average.
Get system pricesGet 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.
Get temperatureGet 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.
Get the 14-day demand forecastGet the forecast peak national and transmission demand for each of the next two weeks, from National Grid's latest forecast.
Get the current generation mixSee 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.
Get the day-ahead demand forecastGet National Grid's latest half-hourly forecast of national and transmission demand for the rest of today and tomorrow, with the forecast peak.
Get the wind and solar forecastGet the forecast of solar, onshore wind and offshore wind output for each half hour, day ahead or intraday.
Get the wind generation forecastGet National Grid's latest forecast of metered wind generation for the next day and a half, hour by hour, with its peak.
Get wind and solar generationGet 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.
List BM unitsList 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.
List system warningsList 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.
Search REMIT messagesFind 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.

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 idmessage_idnumberRequired
The message's id, which 'Search REMIT messages' and the trigger return.At least 1.

Outputs

affected_unittext
The unit affected
asset_idtext
The asset's id, often its BM unit
available_capacity_mwnumber
What is available during the event, in MW
causetext
The cause given, if any
event_endtext
When it ends, in UTC
event_starttext
When the event starts, in UTC
event_statustext
Active, Inactive or Dismissed
event_typetext
Such as Production unavailability
fuel_typetext
The unit's fuel, such as Fossil Gas
headingtext
The message's heading
idnumber
Elexon's id for this revision of the message
message_typetext
The kind of message, such as UnavailabilitiesOfElectricityFacilities
mridtext
The message's own id, shared by all its revisions
normal_capacity_mwnumber
Its normal capacity, in MW
participant_idtext
The market participant's id
published_attext
When the participant published it, in UTC
related_informationtext
Anything else the participant added
revision_numbernumber
Which revision this is, 1 for the first
unavailability_typetext
Planned or Unplanned, empty for other messages
unavailable_capacity_mwnumber
What is unavailable during the event, in MW
Example output
{
  "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 unitbm_unittextRequired
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.
Fromfrom_timedate 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.
Toto_timedate and time
The end of the range. Leave it empty for now, or 24 hours after the start.

Outputs

bm_unittext
The unit's Elexon id
bm_unit_nametext
The unit's name
countnumber
How many pairs there are
from_timetext
The start of the range, in UTC
pairslist
Every bid-offer pair, oldest first
to_timetext
The end of the range, in UTC
Example output
{
  "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

Fromfrom_datedate
The first day. Leave both dates empty for the last seven days.
Toto_datedate
The last day. Leave it empty for up to today.

Outputs

countnumber
How many days there are
dayslist
One row per day, oldest first
from_datetext
The first day
highest_datetext
The day it came on
highest_demand_mwnumber
The highest of the peaks, in MW
to_datetext
The last day
Example output
{
  "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

Fromfrom_datedate
The first UK settlement date. Leave it empty for today. Up to 28 days can be asked for at a time.
Toto_datedate
The last settlement date. Leave it empty for up to today.

Outputs

average_national_demand_mwnumber
Average national demand, in MW
countnumber
How many half hours there are
demandlist
Every half hour, oldest first
from_datetext
The first settlement date
peak_national_demand_mwnumber
Highest national demand, in MW
peak_timetext
When that peak was, in UTC
to_datetext
The last settlement date
Example output
{
  "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

Fromfrom_datedate
The first UK settlement date. Leave it empty for today. Up to 7 days can be asked for at a time.
Toto_datedate
The last settlement date. Leave it empty for up to today.
Fuel typesfuel_typeslist
Only these fuels. Leave it empty for every fuel and interconnector.
Resolutionresolutiontext
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

countnumber
How many readings there are
from_datetext
The first settlement date
fuel_summarylist
Each fuel's average and peak, largest first
generationlist
Every reading, oldest first
resolutiontext
half_hourly or five_minute
to_datetext
The last settlement date
Example output
{
  "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

Fromfrom_datedate
The first UK settlement date. Leave it empty for today. Up to 7 days can be asked for at a time.
Toto_datedate
The last settlement date. Leave it empty for up to today.
Interconnectorsinterconnectorslist
Only these links. Leave it empty for all of them.

Outputs

countnumber
How many flows there are
flowslist
Every half-hourly flow, oldest first
from_datetext
The first settlement date
interconnector_summarylist
Each link's average
to_datetext
The last settlement date
Example output
{
  "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

Fromfrom_timedate 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.
Toto_timedate and time
The end of the range. Leave it empty for now, or 24 hours after the start.
Exchangeprovidertext
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

countnumber
How many prices there are
from_timetext
The start of the range, in UTC
priceslist
Every half hour and exchange, oldest first
to_timetext
The end of the range, in UTC
total_volume_mwhnumber
The volume traded over the range, in MWh
volume_weighted_pricenumber
The average price weighted by volume, in £ per MWh
Example output
{
  "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 unitbm_unittextRequired
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.
Fromfrom_timedate 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.
Toto_timedate and time
The end of the range. Leave it empty for now, or 24 hours after the start.
What to includedatasetslist
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_unittext
The unit's Elexon id
bm_unit_nametext
The unit's name
countnumber
How many levels there are
from_timetext
The start of the range, in UTC
levelslist
Every level, oldest first
to_timetext
The end of the range, in UTC
Example output
{
  "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

Fromfrom_timedate and time
The start of the range. Leave it empty for an hour before the end.
Toto_timedate and time
The end of the range, at most 24 hours after the start. Leave it empty for now.

Outputs

average_hznumber
The average frequency, in hertz
countnumber
How many readings there are
from_timetext
The start of the range, in UTC
highest_hznumber
The highest reading, in hertz
highest_timetext
When it was, in UTC
lowest_hznumber
The lowest reading, in hertz
lowest_timetext
When it was, in UTC
readingslist
Every reading, oldest first
to_timetext
The end of the range, in UTC
Example output
{
  "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 datesettlement_datedate
The UK settlement date. Leave it empty for today.

Outputs

average_pricenumber
The day's average sell price, in £ per MWh
countnumber
How many periods have prices
highest_periodnumber
The period it came in
highest_pricenumber
The highest sell price, in £ per MWh
lowest_periodnumber
The period it came in
lowest_pricenumber
The lowest sell price, in £ per MWh
priceslist
One row per settlement period
settlement_datetext
The settlement date
Example output
{
  "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

Fromfrom_datedate
The first day. Leave both dates empty for the last week.
Toto_datedate
The last day. Leave it empty for up to today.

Outputs

average_cnumber
The average over the range, in Celsius
countnumber
How many days there are
dayslist
One row per day, oldest first
from_datetext
The first day
to_datetext
The last day
Example output
{
  "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

countnumber
How many days are forecast
dayslist
One row per day, soonest first
published_attext
When the forecast was published, in UTC
Example output
{
  "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

countnumber
How many fuels are listed
fuelslist
One row per fuel, largest first
generation_mwnumber
Generation in Great Britain now, in MW
imports_mwnumber
Imports through interconnectors now, in MW
largest_sourcetext
The fuel supplying the most now
largest_source_percentnumber
Its share now, in percent
total_mwnumber
Total supply now, including imports, in MW
Example output
{
  "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

countnumber
How many half hours are forecast
forecastslist
Every forecast half hour, oldest first
peak_national_demand_mwnumber
The forecast national peak, in MW
peak_timetext
When that peak is forecast, in UTC
published_attext
When the forecast was published, in UTC
Example output
{
  "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

Fromfrom_timedate and time
The start of the range. Leave it empty for now.
Toto_timedate and time
The end of the range. Leave it empty for 24 hours after the start.
Forecastforecast_typetext
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

countnumber
How many forecast values there are
forecast_typetext
The forecast asked for
forecastslist
Every half hour and source, oldest first
from_timetext
The start of the range, in UTC
to_timetext
The end of the range, in UTC
Example output
{
  "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

countnumber
How many forecast values there are
forecastslist
Every forecast hour, oldest first
peak_mwnumber
The highest forecast output, in MW
peak_timetext
When that peak is forecast, in UTC
published_attext
When the forecast was published, in UTC
Example output
{
  "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

Fromfrom_timedate 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.
Toto_timedate and time
The end of the range. Leave it empty for now, or 24 hours after the start.

Outputs

countnumber
How many readings there are
from_timetext
The start of the range, in UTC
generationlist
Every half hour and source, oldest first
source_summarylist
Each source's average and peak
to_timetext
The end of the range, in UTC
Example output
{
  "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 typesfuel_typeslist
Only units of these fuels. Leave it empty for every unit.
Companylead_partytext
Only units this company runs: part of its name, or its id.
Name or id containsname_containstext
Only units whose name or id contains this text.
How many to returnlimitnumber
How many units to return at most, by id. Defaults to 50.From 1 to 3500. Default: 50.

Outputs

countnumber
How many units are returned
matched_countnumber
How many matched in all
unitslist
The units, by id
Example output
{
  "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

Fromfrom_timedate and time
The start of the range. Leave it empty for a week before the end.
Toto_timedate and time
The end of the range, at most a year after the start. Leave it empty for now.
Warning typewarning_typetext
Only this kind of warning. Leave it empty for every kind.

Outputs

countnumber
How many warnings there are
from_timetext
The start of the range, in UTC
to_timetext
The end of the range, in UTC
warning_typetext
The kind asked for, empty for every kind
warningslist
The warnings, oldest first
Example output
{
  "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 fromfrom_timedate and time
The start of the range. Leave it empty for 24 hours before the end. At most 7 days.
Published toto_timedate and time
The end of the range. Leave it empty for now.
Participantparticipanttext
Only messages from this market participant.
Assetassettext
Only messages about this asset, often a BM unit id.
Fuel typefuel_typetext
Only messages about units of this fuel.
Planned or unplannedunavailability_typetext
Only planned or only unplanned outages. Leave it empty for both.
How many to returnlimitnumber
How many messages to return at most, newest first. Defaults to 25.From 1 to 200. Default: 25.

Outputs

countnumber
How many messages are returned
from_timetext
The start of the range, in UTC
matched_countnumber
How many matched in all
messageslist
The messages, newest first
to_timetext
The end of the range, in UTC
Example output
{
  "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"
}

On this page