---
title: "Fetch message details by mRID"
method: GET
path: "/remit/search"
tags: ["REMIT"]
---

# Fetch message details by mRID

`GET /remit/search`

This endpoint provides one or more REMIT messages based on the given mRID and revision number. If none is given
it returns the REMIT message revision with the latest revision number.

## Query parameters

- `mrid` string, required
- `revisionNumber` integer
- `format` 'json' | 'xml'

## Response `200`

Data retrieved

- InsightsApiModelsResponsesResponseWithMetadata1InsightsApiModelsResponsesTransparencyRemitRemitMessageWithId
  - `data` InsightsApiModelsResponsesTransparencyRemitRemitMessageWithId[], nullable
    - `dataset` string, nullable
    - `mrid` string, nullable
    - `revisionNumber` integer
    - `publishTime` string, date-time
    - `createdTime` string, date-time
    - `messageType` string, nullable
    - `messageHeading` string, nullable
    - `eventType` string, nullable
    - `unavailabilityType` string, nullable
    - `participantId` string, nullable
    - `registrationCode` string, nullable
    - `assetId` string, nullable
    - `assetType` string, nullable
    - `affectedUnit` string, nullable
    - `affectedUnitEIC` string, nullable
    - `affectedArea` string, nullable
    - `biddingZone` string, nullable
    - `fuelType` string, nullable
    - `normalCapacity` number, double, nullable
    - `availableCapacity` number, double, nullable
    - `unavailableCapacity` number, double, nullable
    - `eventStatus` string, nullable
    - `eventStartTime` string, date-time
    - `eventEndTime` string, date-time, nullable
    - `durationUncertainty` string, nullable
    - `cause` string, nullable
    - `relatedInformation` string, nullable
    - `outageProfile` InsightsApiModelsResponsesTransparencyRemitDatasetRowsOutageProfileData[], nullable
      - `startTime` string, date-time
      - `endTime` string, date-time
      - `capacity` number, double
    - `id` integer
  - `metadata` InsightsApiModelsMetadataApiResponseSourceMetadata
    - `datasets` string[], nullable

## Other responses

- `400` — Error with query parameters - see response for details
- `404` — No data found for given query parameters
- `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)