---
title: "Settlement messages by settlement date (SMSG)"
method: GET
path: "/balancing/settlement/messages/{settlementDate}"
tags: ["Indicative Imbalance Settlement"]
---

# Settlement messages by settlement date (SMSG)

`GET /balancing/settlement/messages/{settlementDate}`

Returns settlement messages generated by the SAA for a given settlement day, relating to the data
for a settlement run.
            
For each settlement period within the range, only messages generated for the latest settlement run are returned.
            
Settlement date parameter must be provided in the exact format yyyy-MM-dd.

## Path parameters

- `settlementDate` string, date, required

## Query parameters

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

## Response `200`

Data retrieved

- InsightsApiModelsResponsesResponseWithMetadata1InsightsApiModelsResponsesBalancingSettlementSettlementMessageResponse
  - `data` InsightsApiModelsResponsesBalancingSettlementSettlementMessageResponse[], nullable
    - `settlementDate` string, date
    - `settlementPeriod` integer
    - `startTime` string, date-time
    - `messageReceivedDateTime` string, date-time
    - `messageSeverity` string, nullable
    - `messageTypeCode` string, nullable
    - `messageType` string, nullable
    - `messageText` string, nullable
  - `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)