---
title: "Half-hourly generation outturn by fuel type (FUELHH) stream"
method: GET
path: "/datasets/FUELHH/stream"
tags: ["BMRS Datasets"]
---

# Half-hourly generation outturn by fuel type (FUELHH) stream

`GET /datasets/FUELHH/stream`

This endpoint provides the half-hourly generation outturn (Generation By Fuel type)
to give our users an indication of the generation outturn for Great Britain.
The data is aggregated by Fuel Type category and updated at 30-minute intervals with
average MW values over 30 minutes for each category.
            
This endpoint includes additional settlement parameters such as Settlement Date and Settlement Period.
The Settlement Date fields cannot be set when a Publish Date field is set.
            
Settlement date parameters must be provided in the exact format yyyy-MM-dd.
            
This endpoint has an optimised JSON payload and is aimed at frequent requests for the data.

## Query parameters

- `publishDateTimeFrom` string, date-time
- `publishDateTimeTo` string, date-time
- `settlementDateFrom` string, date
- `settlementDateTo` string, date
- `settlementPeriod` integer[]
- `fuelType` string[]

## Response `200`

Data retrieved

- InsightsApiModelsResponsesGenerationDatasetRowsAugmentedOutturnData[]
  - `dataset` string, nullable
  - `publishTime` string, date-time, nullable
  - `startTime` string, date-time, nullable
  - `settlementDate` string, date, nullable
  - `settlementPeriod` integer, nullable
  - `fuelType` string, nullable
  - `generation` integer, nullable

## Other responses

- `400` — Error with query parameters - see response for details
- `429` — Too many requests
- `500` — Server error - please try again later

---

[API](https://skmtc.net/elexon/apis/bmrs-insights.md) · [All operations](https://skmtc.net/elexon/apis/bmrs-insights/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elexon/bmrs-insights/versions/d94e9edb295e/schema)