---
title: "Historic acceptances by settlement period (ISPSTACK, BOALF, BOD)"
method: GET
path: "/balancing/settlement/acceptances/all/{settlementDate}/{settlementPeriod}"
tags: ["Indicative Imbalance Settlement"]
---

# Historic acceptances by settlement period (ISPSTACK, BOALF, BOD)

`GET /balancing/settlement/acceptances/all/{settlementDate}/{settlementPeriod}`

Returns the bid and offer prices for acceptances, with the acceptance number and acceptance time. Results are sorted by descending acceptance time.
            
Settlement date parameter must be provided in the exact format yyyy-MM-dd.

## Path parameters

- `settlementDate` string, date, required
- `settlementPeriod` integer, required

## Query parameters

- `format` 'json' | 'xml' | 'csv'

## Response `200`

Data retrieved

- InsightsApiModelsResponsesResponseWithMetadata1InsightsApiModelsResponsesBalancingSettlementHistoricAcceptanceResponse
  - `data` InsightsApiModelsResponsesBalancingSettlementHistoricAcceptanceResponse[], nullable
    - `settlementDate` string, date
    - `settlementPeriod` integer
    - `bmUnit` string, nullable
    - `nationalGridBmUnit` string, nullable
    - `acceptanceNumber` integer
    - `acceptanceTime` string, date-time
    - `bidPrice` number, double, nullable
    - `offerPrice` number, double, nullable
    - `bidOfferPairId` 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)