---
title: "2 to 156 Weeks Ahead Generation availability aggregated by Balancing Mechanism Units"
method: GET
path: "/gb/elexon/forecasts/uou2t3yw"
tags: ["Elexon"]
---

# 2 to 156 Weeks Ahead Generation availability aggregated by Balancing Mechanism Units

`GET /gb/elexon/forecasts/uou2t3yw`

## Request

- Base URL: `https://api.modoenergy.com/pub/v1`
- URL: `https://api.modoenergy.com/pub/v1/gb/elexon/forecasts/uou2t3yw`
- Auth: one of:
  - API key in header `X-Token`
  - none

This endpoint forward view of availability (also referred to as Output Usable data under the Grid Code) for generation and interconnector capacity, accounting for planned outages covering availability data from 2 weeks ahead to 156 weeks ahead; it is aggregated by Balancing Mechanism Units (BMUs).  In the context of this report, BMUs can be considered as generating units. Elexon BMUs differs from NGC BMUs by including a prefix e.g. 'T_'. The mapping between NGC and Elexon BMUs can be retrieved via reference data API endpoints.

## Query parameters

- `publish_date_from` string, date-time, required
- `publish_date_to` string, date-time, required
- `limit` integer
- `offset` integer
- `timezone` 'UTC' | 'Europe/Berlin' | 'Europe/London' | 'America/New_York' | 'America/Chicago' | 'America/Los_Angeles'

## Response `200`

Success

- object
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` ElexonUOU2T3YW[], required
    - `dataset` string
    - `fuelType` string
    - `nationalGridBmUnit` string
    - `bmUnit` string
    - `publishTime` string, date-time
    - `week` integer
    - `year` integer
    - `outputUsable` integer

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `429`: Too Many Requests

---

[API](https://skmtc.dev/modoenergy/apis/modo-energy-api.md) - [All operations](https://skmtc.dev/modoenergy/apis/modo-energy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/modoenergy/apis/modo-energy-api/revisions/7d9d1bd6ee06?raw)