---
title: "Balancing Energy Bids (BEB) stream"
method: GET
path: "/datasets/BEB/stream"
tags: ["BMRS Datasets"]
---

# Balancing Energy Bids (BEB) stream

`GET /datasets/BEB/stream`

This endpoint provides information on all balancing energy bids, in accordance with the Electricity Balancing Guidelines (EBGL) article 12.3.b.

This endpoint has an optimised JSON payload and is aimed at frequent requests for the data.

## Query parameters

- `publishDateTimeFrom` string, date-time, required
- `publishDateTimeTo` string, date-time, required

## Response `200`

Data retrieved

- InsightsApiModelsResponsesTransparencyDatasetRowsBebDatasetRow[]
  - `dataset` string, nullable
  - `documentId` string, nullable
  - `documentRevisionNumber` integer
  - `publishTime` string, date-time
  - `bidId` string, nullable
  - `flowDirection` string, nullable
  - `quantity` number, double
  - `energyPrice` number, double
  - `startTime` string, date-time
  - `settlementDate` string, date
  - `settlementPeriod` integer

## 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)