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
| Action | What it does |
|---|---|
| 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. |
| 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. |
| Get daily peak demand | Get each day's peak transmission demand and the half hour it came in, for up to a year. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| Get system frequency | Get the grid's frequency every 15 seconds for up to 24 hours, with its lowest, highest and average. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
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_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 unit
bm_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.
- From
from_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.
- To
to_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
- From
from_datedate - The first day. Leave both dates empty for the last seven days.
- To
to_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
- From
from_datedate - The first UK settlement date. Leave it empty for today. Up to 28 days can be asked for at a time.
- To
to_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
- From
from_datedate - The first UK settlement date. Leave it empty for today. Up to 7 days can be asked for at a time.
- To
to_datedate - The last settlement date. Leave it empty for up to today.
- Fuel types
fuel_typeslist - Only these fuels. Leave it empty for every fuel and interconnector.
- Resolution
resolutiontext - 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
- From
from_datedate - The first UK settlement date. Leave it empty for today. Up to 7 days can be asked for at a time.
- To
to_datedate - The last settlement date. Leave it empty for up to today.
- Interconnectors
interconnectorslist - 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
- From
from_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.
- To
to_timedate and time - The end of the range. Leave it empty for now, or 24 hours after the start.
- Exchange
providertext - 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 unit
bm_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.
- From
from_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.
- To
to_timedate and time - The end of the range. Leave it empty for now, or 24 hours after the start.
- What to include
datasetslist - 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
- From
from_timedate and time - The start of the range. Leave it empty for an hour before the end.
- To
to_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 date
settlement_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
- From
from_datedate - The first day. Leave both dates empty for the last week.
- To
to_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
- From
from_timedate and time - The start of the range. Leave it empty for now.
- To
to_timedate and time - The end of the range. Leave it empty for 24 hours after the start.
- Forecast
forecast_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
- From
from_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.
- To
to_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 types
fuel_typeslist - Only units of these fuels. Leave it empty for every unit.
- Company
lead_partytext - Only units this company runs: part of its name, or its id.
- Name or id contains
name_containstext - Only units whose name or id contains this text.
- How many to return
limitnumber - 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
- From
from_timedate and time - The start of the range. Leave it empty for a week before the end.
- To
to_timedate and time - The end of the range, at most a year after the start. Leave it empty for now.
- Warning type
warning_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 from
from_timedate and time - The start of the range. Leave it empty for 24 hours before the end. At most 7 days.
- Published to
to_timedate and time - The end of the range. Leave it empty for now.
- Participant
participanttext - Only messages from this market participant.
- Asset
assettext - Only messages about this asset, often a BM unit id.
- Fuel type
fuel_typetext - Only messages about units of this fuel.
- Planned or unplanned
unavailability_typetext - Only planned or only unplanned outages. Leave it empty for both.
- How many to return
limitnumber - 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"
}