---
title: "List starred (saved) messages on the account"
method: GET
path: "/addresses/starred/messages"
tags: ["Messages"]
---

# List starred (saved) messages on the account

`GET /addresses/starred/messages`

Get a list of messages that have been saved and made private for the entire account using the "star message" feature.

Messages recieved via the Capture Service will also show up as starred IF the `capturePrivate` flag on the account is enabled.

## Response `200`

List of email messages

- EmailMessage[] — List of full email message objects
  - `_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.

---

[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/revisions/5f8b55c76229/schema)