---
title: "Bid-offer data per BMU (BOD)"
method: GET
path: "/balancing/bid-offer"
tags: ["Bid-Offer"]
---

# Bid-offer data per BMU (BOD)

`GET /balancing/bid-offer`

This endpoint provides the bid-offer data for a requested BMU. It returns the data valid over a given time
range, excluding any results where LevelFrom and LevelTo are both zero.
            
By default, the from and to parameters filter the data inclusively and this endpoint will return any data that
overlaps even at a single instant. If the settlementPeriodFrom or settlementPeriodTo parameters are provided, it
will instead filter to return any data that overlaps with the specified range of settlement periods. It is
possible to search using a combination of time and/or settlement date & settlement period. Note: When
filtering via settlement date, from/to are treated as Dates only, with the time being ignored. For example,
2022-06-01T00:00Z and 2022-06-01T11:11Z are both treated as the settlement date 2022-06-01.
            
All Dates and DateTimes should be expressed as defined within
<a href="https://datatracker.ietf.org/doc/html/rfc3339#section-5.6" target="_blank">RFC 3339</a>.
            
Some examples of date parameter combinations are shown below.
            
Filtering by timeFrom and timeTo:
            
    /balancing/bid-offer?bmUnit=T_DRAXX-1&from=2022-06-01T00:00Z&to=2022-07-01T00:00Z
            
Filtering from timeFrom to settlement date and period:
            
    /balancing/bid-offer?bmUnit=T_DRAXX-1&from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodTo=1
            
Filtering from settlement date and period to TimeTo:
            
    /balancing/bid-offer?bmUnit=T_DRAXX-1&from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1
            
Filtering from settlement date and period to settlement date and period:
            
    /balancing/bid-offer?bmUnit=T_DRAXX-1&from=2022-06-01T00:00Z&to=2022-07-01T00:00Z&settlementPeriodFrom=1&settlementPeriodTo=1

## Query parameters

- `bmUnit` string, required
- `from` string, date-time, required
- `to` string, date-time, required
- `settlementPeriodFrom` integer
- `settlementPeriodTo` integer
- `format` 'json' | 'xml' | 'csv'

## Response `200`

Data retrieved

- InsightsApiModelsResponsesResponseWithMetadata1InsightsApiModelsResponsesBalancingBidOfferResponse
  - `data` InsightsApiModelsResponsesBalancingBidOfferResponse[], nullable
    - `settlementDate` string, date
    - `settlementPeriod` integer
    - `nationalGridBmUnit` string, nullable
    - `bmUnit` string, nullable
    - `timeFrom` string, date-time
    - `timeTo` string, date-time
    - `levelFrom` integer
    - `levelTo` integer
    - `bid` number, double
    - `offer` number, double
    - `pairId` integer
  - `metadata` InsightsApiModelsMetadataApiResponseSourceMetadata
    - `datasets` string[], 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/revisions/d94e9edb295e/schema)