---
title: "List messages for an domain"
method: GET
path: "/domains/{domain}/messages"
tags: ["Messages"]
---

# List messages for an domain

`GET /domains/{domain}/messages`

Get a list of messages across any inboxes of a domain. 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}`.

The domain must be owned by the account making the request, and have DNS validated.
Paginate with `until?=<Date>` and `limit=<uint>`.

## Response `200`

Email messages

- EmailMessageShort[] — List of condensed email message objects
  - `inbox` Inbox — unresolved $ref
  - `to` To — unresolved $ref
  - `from` From — unresolved $ref
  - `subject` Subject — unresolved $ref
  - `originalInbox` OriginalInbox — unresolved $ref
  - `size` Size — unresolved $ref
  - `attachments` Attachments — unresolved $ref
  - `received` Received — unresolved $ref
  - `bcc` Bcc — unresolved $ref
  - `cc` Cc — unresolved $ref
  - `domain` Domain — unresolved $ref
  - `folder` Folder — unresolved $ref
  - `ip` Ip — unresolved $ref
  - `labels` Labels — unresolved $ref
  - `links` Links — unresolved $ref
  - `read` Read — unresolved $ref
  - `rtls` Rtls — unresolved $ref
  - `savedBy` SavedBy — unresolved $ref
  - `spam` Spam — unresolved $ref
  - `via` Via — unresolved $ref

## Other responses

- `401` — Not authorized. You may need to log in first.
- `403` — Requested email address is owned by another user

---

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