---
title: "BR Buy Orders"
method: GET
path: "/gb/national-grid/br/buy-orders"
tags: ["NESO"]
---

# BR Buy Orders

`GET /gb/national-grid/br/buy-orders`

Details of all buy orders submitted by NG ESO in the Balancing Reserve service.

## Query parameters

- `date_from` string, date-time, required
- `date_to` string, date-time, required
- `limit` integer
- `offset` integer

## Response `200`

Success

- object
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` BRBuyOrders[], required
    - `auction_id` integer, required
    - `order_id` integer, required
    - `service_type` string, required
    - `service` string, required
    - `delivery_start` string, date-time, required
    - `delivery_end` string, date-time, required
    - `quantity` number, required
    - `price` number, required
    - `joined_family` number, required
    - `substitutability_family` integer, required
    - `paradoxically_acceptance_allowed` string, required
    - `order_entry_time` string, date-time, required
    - `acceptance_ratio` number, required
    - `status` string, required
    - `cleared_volume` number, required
    - `clearing_price` number, required
    - `reason_rejected` integer, required
    - `settlement_date` string, date, required
    - `settlement_period` integer, required

## Other responses

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

---

[API](https://skmtc.net/modoenergy/apis/modo-energy-api.md) · [All operations](https://skmtc.net/modoenergy/apis/modo-energy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/modoenergy/modo-energy-api/revisions/6c4b83d3fc12/schema)