---
title: "List mailboxes"
method: GET
path: "/mailboxes"
tags: ["Mailboxes"]
---

# List mailboxes

`GET /mailboxes`

## Request

- Base URL: `https://warmysender.com/api/v1`
- URL: `https://warmysender.com/api/v1/mailboxes`
- Auth: HTTP bearer

Returns connected mailboxes, newest first, with cursor pagination. Soft-deleted mailboxes are excluded unless you filter by status=deleted. Each mailbox carries `campaigns` — the campaigns it sends for (`id`, `name`, `status`, `channel`; running first, up to 50) — and the exact `campaign_count`. Each mailbox also carries `campaign_stats` for the last `stats_days` days: campaign emails it sent and, of those, how many were opened, clicked or bounced (each email counted once — the same counting as the campaign pages), plus how many people it emailed replied. `open_rate` / `click_rate` are null when nothing with tracking on was sent (not measured, not 0%).

Required scope: `mailboxes:read`.

Returns a cursor-paginated list — pass `cursor` from the previous page to continue.

## Query parameters

- `limit` integer
- `cursor` string
- `external_id` string
- `email_address` string
- `status` 'created' | 'testing' | 'connected' | 'error' | 'deleted'
- `warmup_enabled` 'true' | 'false'
- `stats_days` integer

## Response `200`

Success

## Other responses

- `401`: `unauthorized` — Missing or invalid API key.
- `403`: `insufficient_scope` — The API key lacks the scope this endpoint requires.
- `429`: `rate_limited` — Too many requests — slow down and retry after the Retry-After delay.

---

[API](https://skmtc.dev/warmysender/apis/warmysender-public-api.md) · [All operations](https://skmtc.dev/warmysender/apis/warmysender-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/warmysender/apis/warmysender-public-api/revisions/289e9c167a1a?raw)