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

# List messages by event time

`GET /remit/list/by-event`

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

## 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
- `format` 'json' | 'xml'

## Response `200`

Data retrieved

- InsightsApiModelsResponsesResponseWithMetadata1InsightsApiModelsResponsesTransparencyRemitRemitMessageIdentifierWithUrl
  - `data` InsightsApiModelsResponsesTransparencyRemitRemitMessageIdentifierWithUrl[], nullable
    - `id` integer
    - `mrid` string, nullable
    - `revisionNumber` integer
    - `createdTime` string, date-time
    - `publishTime` string, date-time
    - `url` 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)