---
title: "List messages by publish time (stream)"
method: GET
path: "/remit/list/by-publish/stream"
tags: ["REMIT"]
---

# List messages by publish time (stream)

`GET /remit/list/by-publish/stream`

## Request

- Base URL: `https://data.elexon.co.uk/bmrs/api/v1`
- URL: `https://data.elexon.co.uk/bmrs/api/v1/remit/list/by-publish/stream`
- Auth: none declared

This endpoint provides a list of REMIT message identifiers based on the publish time and other optional parameters.
            
- Filtering by LatestRevisionOnly (default = true):
   if true, include only the latest revision of each message.
            
- Filtering by ProfileOnly (default = false):
    if true, include only messages with an outage profile.
            
This endpoint has an optimised JSON payload and is aimed at frequent requests for this data.

## Query parameters

- `from` string, date-time, required
- `to` string, date-time, required
- `participantId` string
- `assetId` string
- `messageType` string
- `unavailabilityType` string
- `eventType` string[]
- `fuelType` string[]
- `latestRevisionOnly` boolean
- `profileOnly` boolean

## Response `200`

Data retrieved

- InsightsApiModelsResponsesTransparencyRemitRemitMessageIdentifierWithUrl[]
  - `id` integer
  - `mrid` string, nullable
  - `revisionNumber` integer
  - `createdTime` string, date-time
  - `publishTime` string, date-time
  - `url` 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.dev/elexon/apis/bmrs-insights.md) - [All operations](https://skmtc.dev/elexon/apis/bmrs-insights/llms.txt) - [OpenAPI document](https://skmtc.dev/elexon/apis/bmrs-insights/revisions/d992cbaa9351?raw)