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

# List messages by event time (stream)

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

This endpoint provides a list of REMIT message identifiers based on the event start, end 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.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)