# List messages

`GET /mailboxes/{mailbox}/messages` · Praecise Inbox · Mailboxes

The newest messages in a folder: sender, subject, date, a snippet, and whether each is unread.

## Parameters

- `mailbox` (path, required), string: Mailbox address.
- `folder` (query), string
- `limit` (query), integer
- `q` (query), string: When present, searches across folders instead of listing one.

## Responses

- `200`: List messages
- `401`: No valid access key.
- `403`: The key may not do this on this mailbox.
- `429`: Too many calls; see Retry-After.

## Example

```sh
curl -X GET 'https://email.inbox.praecise.com/api/mailboxes/{mailbox}/messages' \
  -H 'Authorization: Bearer $KEY'
```