---
title: "List messages for an email inbox"
method: GET
path: "/addresses/{email}/messages"
tags: ["Messages"]
---

# List messages for an email inbox

`GET /addresses/{email}/messages`

Get a list of messages for the email address. Messages are always **sorted in decending order by when they were received**, with the newest message always in the first position of the array.

The email message objects are abbreviated to provide basic meta data. To get more information about a specific message, use `GET /api/addresses/{email}/messages/{messageId}`.

**It is NOT necessary to reserve the address** before checking mail! Whether it is an address on a custom domain, or a public domain, or mailsac.com, the mail can be checked with this route.

## Response `200`

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.
- `403` — Requested email address is owned by another user

---

[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)