---
title: "List messages across all inboxes (workspace-wide)"
method: GET
path: "/v1/messages"
tags: ["Messages"]
---

# List messages across all inboxes (workspace-wide)

`GET /v1/messages`

## Request

- Base URL: `https://api.deadsimple.email`
- URL: `https://api.deadsimple.email/v1/messages`
- Auth: HTTP bearer

For supervisor agents monitoring every inbox in a workspace.

## Query parameters

- `limit` integer
- `cursor` string
- `direction` 'inbound' | 'outbound'

## Headers

- `X-Workspace-Id` string, uuid

## Response `200`

List of messages

---

[API](https://skmtc.dev/deadsimple/apis/dead-simple-email-api.md) · [All operations](https://skmtc.dev/deadsimple/apis/dead-simple-email-api/llms.txt) · [OpenAPI document](https://skmtc.dev/deadsimple/apis/dead-simple-email-api/revisions/c697881be131?raw)