Skip to content
Docs

Get Account Warmup

Warmup progress, pool stats and recent warmup logs for one email account.

GEThttps://api.foxreach.io/api/v1/email-accounts/{account_id}/warmup

Requires an API key with the read scope.

Path Parameters#

account_idstringpathrequired

The unique identifier of the email account.

Response#

dataobject

Warmup detail for the account.

Show data
warmupProgressobject
Ramp progress: enabled, progress (percent), currentLimit, targetLimit, and once warmup has started daysCompleted and totalDays. The last two keys are absent when warmup is off or not started.
poolStatsobject
Warmup pool activity: sentCount, receivedCount and replyCount. All 0 when the account has never been in the pool.
logsarray

The account's last 20 warmup logs, as sender or receiver, newest first.

Show logs
idstring
Log identifier.
senderEmailstring
Sending mailbox, or unknown.
receiverEmailstring
Receiving mailbox, or unknown.
subjectstring
Subject line.
statusstring
sent, received, replied or failed (the peer account rejected the recipient).
repliedAtstring
When the reply was sent, or null.
createdAtstring
ISO 8601 timestamp.
warmupIdentifierstring
Warmup identifier, or null.
warmupIdentifierInSubjectboolean
Whether the identifier is added to warmup subjects.
warmupAccountCodestring
The account's warmup code, or null.
warmupSubjectCodeEnabledboolean
Whether the code is added to warmup subjects.
warmupDynamicTagEnabledboolean
Whether warmup mail carries a per-message tag.

Errors#

StatusDescription
401Missing, invalid, revoked or expired API key
403API key does not have the required scope: read
404Email account not found, or it belongs to another workspace

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.

Was this page helpful?
View as MarkdownLast updated November 2, 2026