---
title: "List warmup stats"
method: GET
path: "/warmup/stats"
tags: ["Warmup"]
---

# List warmup stats

`GET /warmup/stats`

## Request

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

Per-mailbox warmup health in BOTH directions: sending-side progress, today's volume, placement and reputation, plus the incoming side — whether warmup is actually arriving at the mailbox (`incoming_warmup_state`), when it last did, and whether it is paused and why. `inbox_rate` measures the SENDING side only; `inbox_rate_measures` spells that out so the two are never conflated. `inbox_rate_scope` says where it is measured: warmup emails between mailboxes in the warmup network, never your own contacts. Cursor paginated.

Required scope: `warmup:read`.

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

## Query parameters

- `limit` integer
- `cursor` string
- `mailbox_id` string

## 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/eb5c7f10a1cd?raw)