> For the complete documentation index, see [llms.txt](https://docs.jua.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.jua.ai/api-v2/query-engine/open-api-reference/uk-power.md).

# Uk Power

Query UK power generation actuals and NESO day-ahead forecasts (wind, solar).

## Query UK power generation data

> Query UK (GB) power generation timeseries data including:\
> \- Wind and solar generation actuals (transmission + embedded)\
> \- Transmission system demand (load)\
> \- Day-ahead wind and solar forecasts (NESO)\
> \
> All variables cover \*\*Great Britain\*\* (England, Scotland, Wales). Northern\
> Ireland is not included — it runs on the separate all-island I-SEM market.\
> All values are in MW, on the half-hourly settlement-period grid (UTC).\
> \
> \*\*Actuals:\*\*\
> \- \`wind\`: Total wind generation, transmission + embedded (Elexon FUELHH + NESO Gen Mix)\
> \- \`wind\_transmission\`: Transmission-connected wind generation (Elexon FUELHH)\
> \- \`wind\_embedded\`: Distribution-embedded wind generation (NESO Gen Mix)\
> \- \`solar\`: Total solar generation (Sheffield Solar PV\_Live)\
> \- \`load\`: Transmission system demand / TSD (NESO Demand)\
> \
> \*\*Day-ahead forecasts (NESO):\*\*\
> \- \`wind\_forecast\`: Day-ahead total wind forecast, transmission + embedded (NESO Day Ahead Wind + NESO Embedded Forecast)\
> \- \`wind\_transmission\_forecast\`: Day-ahead transmission wind forecast (NESO Day Ahead Wind)\
> \- \`wind\_embedded\_forecast\`: Day-ahead embedded wind forecast (NESO Embedded Forecast)\
> \- \`solar\_forecast\`: Day-ahead embedded solar forecast (NESO Embedded Forecast)\
> \
> \*\*Response Formats:\*\*\
> \- \`json\`: Columnar JSON format \`{column: \[values], ...}\`\
> \- \`arrow\`: Apache Arrow IPC stream for efficient processing\
> \
> \*\*Authentication\*\*: Requires API key.\
> \
> For more information, see \[docs.jua.ai]\(<https://docs.jua.ai>).

```json
{"openapi":"3.1.0","info":{"title":"Jua Query Engine API","version":"0.1.0"},"tags":[{"name":"uk-power","description":"Query UK power generation actuals and NESO day-ahead forecasts (wind, solar)."}],"security":[{"HTTPBearer":[]}],"paths":{"/v1/uk-power/data":{"post":{"tags":["uk-power"],"summary":"Query UK power generation data","description":"Query UK (GB) power generation timeseries data including:\n- Wind and solar generation actuals (transmission + embedded)\n- Transmission system demand (load)\n- Day-ahead wind and solar forecasts (NESO)\n\nAll variables cover **Great Britain** (England, Scotland, Wales). Northern\nIreland is not included — it runs on the separate all-island I-SEM market.\nAll values are in MW, on the half-hourly settlement-period grid (UTC).\n\n**Actuals:**\n- `wind`: Total wind generation, transmission + embedded (Elexon FUELHH + NESO Gen Mix)\n- `wind_transmission`: Transmission-connected wind generation (Elexon FUELHH)\n- `wind_embedded`: Distribution-embedded wind generation (NESO Gen Mix)\n- `solar`: Total solar generation (Sheffield Solar PV_Live)\n- `load`: Transmission system demand / TSD (NESO Demand)\n\n**Day-ahead forecasts (NESO):**\n- `wind_forecast`: Day-ahead total wind forecast, transmission + embedded (NESO Day Ahead Wind + NESO Embedded Forecast)\n- `wind_transmission_forecast`: Day-ahead transmission wind forecast (NESO Day Ahead Wind)\n- `wind_embedded_forecast`: Day-ahead embedded wind forecast (NESO Embedded Forecast)\n- `solar_forecast`: Day-ahead embedded solar forecast (NESO Embedded Forecast)\n\n**Response Formats:**\n- `json`: Columnar JSON format `{column: [values], ...}`\n- `arrow`: Apache Arrow IPC stream for efficient processing\n\n**Authentication**: Requires API key.\n\nFor more information, see [docs.jua.ai](https://docs.jua.ai).","operationId":"post_uk_power_data_v1_uk_power_data_post","parameters":[{"name":"format","in":"query","required":false,"schema":{"enum":["json","arrow"],"type":"string","description":"Response format: 'json' or 'arrow'","default":"json","title":"Format"},"description":"Response format: 'json' or 'arrow'"},{"name":"include_units","in":"query","required":false,"schema":{"type":"boolean","description":"When true, JSON responses are wrapped in {data, units}.","default":false,"title":"Include Units"},"description":"When true, JSON responses are wrapped in {data, units}."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UkPowerTimeseriesQuery"}}}},"responses":{"200":{"description":"Successfully retrieved UK power data","content":{"application/json":{"schema":{}},"application/vnd.apache.arrow.stream":{"description":"Apache Arrow IPC stream format"}}},"400":{"description":"Invalid query parameters"},"401":{"description":"Authentication required"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"UkPowerTimeseriesQuery":{"properties":{"variables":{"anyOf":[{"items":{"$ref":"#/components/schemas/UkPowerVariable"},"type":"array"},{"type":"null"}],"title":"Variables","description":"Variables to query. If not set, returns all."},"start_time":{"type":"string","format":"date-time","title":"Start Time","description":"Start time for the query (inclusive)"},"end_time":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End Time","description":"End time for the query (exclusive). If None, no upper bound."},"aggregation":{"$ref":"#/components/schemas/jua_query_v2__uk_power__query__TemporalAggregation","description":"Temporal aggregation to apply","default":"none"},"temporal_resolution_minutes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Temporal Resolution Minutes","description":"Target temporal resolution in minutes.  When set, data is linearly interpolated in ClickHouse to the requested cadence (native NESO data is 30-minute; use 15 for 15-minute interpolation).  Set to None (the default) to return data at its native resolution."},"time_zone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time Zone","description":"IANA time zone for time formatting (e.g. 'Europe/London')."},"order_by":{"anyOf":[{"items":{"$ref":"#/components/schemas/OrderByItem_str_"},"type":"array"},{"type":"null"}],"title":"Order By","description":"Columns to order by (e.g. 'time__desc')."},"pagination":{"anyOf":[{"$ref":"#/components/schemas/Pagination"},{"type":"null"}],"description":"Pagination parameters"}},"type":"object","required":["start_time"],"title":"UkPowerTimeseriesQuery","description":"Query parameters for UK power generation timeseries data.\n\nVariables are aggregated totals:\n- wind: transmission + embedded wind generation\n- solar: total solar generation\n- wind_forecast: day-ahead total wind forecast\n- solar_forecast: day-ahead solar forecast"},"UkPowerVariable":{"type":"string","enum":["wind","wind_transmission","wind_embedded","solar","load","wind_forecast","wind_transmission_forecast","wind_embedded_forecast","solar_forecast"],"title":"UkPowerVariable","description":"UK power generation variable types (aggregated)."},"jua_query_v2__uk_power__query__TemporalAggregation":{"type":"string","enum":["none","hourly","daily"],"title":"TemporalAggregation","description":"Temporal aggregation options for UK power queries."},"OrderByItem_str_":{"properties":{"field":{"type":"string","title":"Field","description":"Field to sort by"},"direction":{"$ref":"#/components/schemas/SortDirection","description":"Sort direction: 'asc' (default) or 'desc'","default":"asc"},"aggregation":{"anyOf":[{"type":"string","enum":["avg","std","min","max","sum","count","median","quantile","argmin","argmax"]},{"type":"null"}],"title":"Aggregation","description":"Aggregation function when ordering by variable"}},"type":"object","required":["field"],"title":"OrderByItem[str]"},"SortDirection":{"type":"string","enum":["asc","desc"],"title":"SortDirection","description":"Sort direction for ORDER BY clauses."},"Pagination":{"properties":{"limit":{"type":"integer","title":"Limit","default":100},"offset":{"type":"integer","title":"Offset","default":0}},"type":"object","title":"Pagination"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}
```

## List available UK power variables

> Get a list of available UK power generation variables with metadata.\
> \
> \*\*Authentication\*\*: Requires API key.

```json
{"openapi":"3.1.0","info":{"title":"Jua Query Engine API","version":"0.1.0"},"tags":[{"name":"uk-power","description":"Query UK power generation actuals and NESO day-ahead forecasts (wind, solar)."}],"security":[{"HTTPBearer":[]}],"paths":{"/v1/uk-power/variables":{"get":{"tags":["uk-power"],"summary":"List available UK power variables","description":"Get a list of available UK power generation variables with metadata.\n\n**Authentication**: Requires API key.","operationId":"get_uk_power_variables_v1_uk_power_variables_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/jua_query_v2__uk_power__types__AvailableVariablesResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"jua_query_v2__uk_power__types__AvailableVariablesResult":{"properties":{"variables":{"items":{"$ref":"#/components/schemas/UkPowerVariableInfo"},"type":"array","title":"Variables"}},"type":"object","required":["variables"],"title":"AvailableVariablesResult","description":"Result for available UK power variables query."},"UkPowerVariableInfo":{"properties":{"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"unit":{"type":"string","title":"Unit"}},"type":"object","required":["name","description","unit"],"title":"UkPowerVariableInfo","description":"Information about a UK power variable."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}
```

## List available UK power data sources

> Get a list of available data sources for UK power generation.\
> \
> \*\*Authentication\*\*: Requires API key.

```json
{"openapi":"3.1.0","info":{"title":"Jua Query Engine API","version":"0.1.0"},"tags":[{"name":"uk-power","description":"Query UK power generation actuals and NESO day-ahead forecasts (wind, solar)."}],"security":[{"HTTPBearer":[]}],"paths":{"/v1/uk-power/sources":{"get":{"tags":["uk-power"],"summary":"List available UK power data sources","description":"Get a list of available data sources for UK power generation.\n\n**Authentication**: Requires API key.","operationId":"get_uk_power_sources_v1_uk_power_sources_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/jua_query_v2__uk_power__types__AvailableSourcesResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"jua_query_v2__uk_power__types__AvailableSourcesResult":{"properties":{"sources":{"items":{"type":"string"},"type":"array","title":"Sources"}},"type":"object","required":["sources"],"title":"AvailableSourcesResult","description":"Result for available UK power data sources query."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.jua.ai/api-v2/query-engine/open-api-reference/uk-power.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.