---
title: "List warming mailboxes"
method: GET
path: "/v1/warming"
tags: ["Warming"]
---

# List warming mailboxes

`GET /v1/warming`

## Request

- Base URL: `https://api.winnr.app`
- URL: `https://api.winnr.app/v1/warming`
- Auth: HTTP bearer

Returns all email users with warming enabled, including cached stats.
Uses offset-based pagination via `page` and `per_page` query parameters.

## Query parameters

- `page` integer
- `per_page` integer
- `sort_by` string
- `order` 'asc' | 'desc'

## Response `200`

List of warming mailboxes

- WarmingMailboxListResponse
  - `data` WarmingMailbox[]
    - `id` string
    - `full_address` string
    - `domain_string` string
    - `name` string
    - `warming_status` 'active' | 'paused' | 'connecting' | 'connection_problem' | 'disabled'
    - `warming_credentials_stale` boolean: True while warming may still hold an old mailbox password (after a password change, until it is passed on). Reconnect clears it.
    - `warming_emails_per_day` integer
    - `warming_response_rate` integer
    - `warming_rampup_enabled` boolean
    - `warming_rampup_speed` 'slow' | 'normal' | 'fast'
    - `warming_health_score` number
    - `warming_inbox_rate` number
    - `warming_spam_rate` number
    - `warming_total_sent` integer
    - `warming_total_replies` integer
    - `warming_started_at` string, date-time, nullable
    - `warming_last_sync` string, date-time, nullable
  - `pagination` Pagination: Pagination metadata. Cursor-based endpoints (e.g. `/v1/domains`, `/v1/email-users`, `/v1/inbox`, `/v1/email-users/{id}/inbox`) populate `has_more` and `cursor`. Offset-based endpoints (e.g. `/v1/warming`) populate `page`, `per_page`, and `total`. `count` (number of items in the current page) is included where available.
    - `has_more` boolean: Whether more pages exist after this one (cursor-based endpoints).
    - `cursor` string, nullable: Opaque cursor to pass as `?cursor=…` for the next page.
    - `count` integer: Number of items returned in this response.
    - `total` integer: Total number of items across all pages (offset-based endpoints).
    - `page` integer: 1-based page number (offset-based endpoints).
    - `per_page` integer: Items per page (offset-based endpoints).
  - `meta` Meta
    - `request_id` string
    - `timestamp` string, date-time

---

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