---
title: "Retrieve message"
method: GET
path: "/v0/messages/{id}"
tags: ["Messages"]
---

# Retrieve message

`GET /v0/messages/{id}`

Retrieve a message

## Path parameters

- `id` string, uuid, required

## Query parameters

- `recompute_mdm_from_raw` boolean, nullable — When true, recompute the MDM from the raw EML. For internal use only!
- `remove_large_text_fields` boolean, nullable — When true, any text field over 1MB will be cleared before returning

## Response `200`

OK

- HandlerTypesMessage
  - `canonical_id` string, required — Canonical ID of the message
  - `created_at` string, date-time, required — Datetime the message was created
  - `external_id` string, nullable — ID of the message in the source system (e.g., Office 365 or Google Workspace)
  - `forward_recipients` string[] — Email addresses this message was forwarded to by the recipient mailbox
  - `forwarded_at` string, date-time, nullable — Time this message was forwarded by the recipient mailbox. A null value indicates that it has not yet been forwarded
  - `id` string, uuid, required — Message ID
  - `landed_in_spam` boolean, nullable — Whether the message landed in the recipient's spam folder
  - `mailbox` HandlerTypesMailbox — Mailbox that the email bomb was found in
    - `email` string, required — Mailbox email address
    - `external_id` string, nullable — ID of the mailbox in the source system (e.g., Office 365 or Google Workspace)
    - `id` string, uuid, required — Mailbox ID
  - `message_source_id` string, uuid, nullable, required — ID of the message source of the message
  - `read_at` string, date-time, nullable — Time this message was read in the user's mailbox. A null value indicates that it has not yet been marked read
  - `recipients` HandlerTypesRecipient[], required — Details of the message recipients
    - `email` string, required — Email address
  - `replied_at` string, date-time, nullable — Time that this message was replied to by the recipient mailbox. A null value indicates that it has not yet been replied to by the recipient
  - `sender` HandlerTypesSender, required — Details of the message sender
    - `display_name` string — Display name
    - `email` string, required — Email address
  - `subject` string, required — Subject of the message

---

[API](https://skmtc.net/sublime/apis/sublime-platform-api.md) · [All operations](https://skmtc.net/sublime/apis/sublime-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sublime/sublime-platform-api/versions/d5df82850357/schema)
