Get Warmup Stats

Aggregate warmup numbers across the workspace.

GEThttps://api.foxreach.io/api/v1/warmup/stats

Requires an API key with the read scope.

Response#

dataobject

Totals.

Show data

totalAccountsinteger

Email accounts in the workspace.

activeWarmupAccountsinteger

Accounts with warmup on.

totalSentinteger

Warmup emails sent by the workspace's accounts.

totalRepliedinteger

Warmup replies counted across the workspace's accounts.

averageHealthScorenumber

Average Health Score over warming accounts that have one, to one decimal. null while none do.

healthMeasuredAccountsinteger

How many accounts the average covers.

Errors#

Status	Description
`401`	Missing, invalid, revoked or expired API key
`403`	API key does not have the required scope: `read`

Rate Limit#

100 requests per minute, per API key. Fixed 60-second window.
Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset (unix epoch seconds).
A 429 response includes a Retry-After header (seconds until the bucket resets).

For client-side patterns (Retry-After, exponential backoff, monitoring X-RateLimit-Remaining), see Rate Limiting.

Request

curl -X GET "https://api.foxreach.io/api/v1/warmup/stats" \
  -H "X-API-Key: otr_your_key"

from foxreach import FoxReach

client = FoxReach(api_key="otr_your_key")
stats = client.warmup.get_stats()

import { FoxReach } from "foxreach";

const client = new FoxReach({ apiKey: "otr_your_key" });
const stats = await client.warmup.stats();

Response

{
  "data": {
    "totalAccounts": 5,
    "activeWarmupAccounts": 4,
    "totalSent": 1280,
    "totalReplied": 1104,
    "averageHealthScore": 91.5,
    "healthMeasuredAccounts": 4
  }
}

Was this page helpful?

View as MarkdownLast updated November 2, 2026