---
title: "Get email message metadata"
method: GET
path: "/addresses/{email}/messages/{messageId}"
tags: ["Messages"]
---

# Get email message metadata

`GET /addresses/{email}/messages/{messageId}`

Retrieves metadata about a single email message. This route includes additional metadata
not available when listing messages, such as parsed links from the text or HTML body, and
attachment md5sums.

To get even more information about message attachments, like filenames, see the
Attachments API.

To get the entire original SMTP message, see the "raw" message route.

## Response `200`

Email message full object

- EmailMessage
  - `_id` string, string — Unique Mailsac-generated identifier for an email message
  - `from` EmailRecipient[] — The FROM sender, this will always have 1 item in the array unless the email was malformed.
    - `name` string — friendly email name, optional part of transport so may be empty string
    - `address` string — email address
  - `to` EmailRecipient[] — The RCPT-TO recipients of the email.
    - `name` string — friendly email name, optional part of transport so may be empty string
    - `address` string — email address
  - `cc` EmailRecipient[] — CarbonCopy recipients of the email.
    - `name` string — friendly email name, optional part of transport so may be empty string
    - `address` string — email address
  - `bcc` EmailRecipient[] — BlindCarbonCopy recipients of the email.
    - `name` string — friendly email name, optional part of transport so may be empty string
    - `address` string — email address
  - `subject` string — Email subject header line. Can be an empty string.
  - `savedBy` string — Indicates a starred message by your account Account._id. Otherwise `null`.
  - `originalInbox` string — Same as inbox unless sent to the encryptedInbox, in which case it would be the encryptedInbox.
  - `inbox` string, email — Email address to which this message belongs.
  - `domain` string, domain — hostname domain for the inbox
  - `received` string, date — Date in ISO 8601
  - `size` number — Content length in bytes of the original raw email message
  - `attachments` Md5sum[] — `null` or array of MD5 hashes of attachments. Use the Attachments API to get metadata and download attachments.
  - `ip` string — The remote SMTP server that send the mail to the server at `via`
  - `via` string — IP address of SMTP server that received the message from `ip`
  - `folder` 'inbox' | 'all' | 'spam' | 'trash' — Inbox folder that this message has been put into
  - `labels` string[] — Custom inbox labels created by the end user
  - `read` boolean — Read/uread status. true=read, false=unread. Only set from the Inbox UI app.
  - `rtls` boolean — When true, indicates the SMTP message was received over TLS (encrypted).
  - `links` string[] — List of any URLs that were found in the text and HTML body of the message.
  - `spam` number — Experimental - result of spam filter scan, between 0.0 and 1.0, where 1.0 indicates a high likelihood of being spam

## Other responses

- `401` — Not authorized. You may need to log in first.
- `404` — Message not found by id...

---

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