Skip to content
Docs

Get Account Health

Deliverability and warmup health for one email account.

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

Requires an API key with the read scope.

Path Parameters#

account_idstringpathrequired

The unique identifier of the email account.

Response#

dataobject

Health and warmup status for the account.

Show data
healthScoreinteger
The Health Score shown in the app: the share of this account's warmup email that landed in the inbox over the last 7 days, 0 to 100. null until enough warmup emails have been measured.
healthBasisobject
The counts behind the score: window, inbox, spam, verified, minVerified, state (measured, building or off), score and weighted.
bounce7dobject
Campaign emails sent and bounced over the last 7 days: {"sent": 120, "bounced": 2}.
warmupHealthinteger
The same number as healthScore, kept for older integrations.
bounceRatenumber
Bounce rate.
replyRatenumber
Reply rate.
sentTodayinteger
Campaign emails sent today. Warmup sends are not counted.
dailyLimitinteger
Campaign emails per day.
connectionStatusstring
Connection state, for example connected.
lastErrorstring
Last connection error, or null.
lastHealthCheckstring
Timestamp of the last health check, or null.
warmupEnabledboolean
Whether warmup is on.
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.
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.
domainAuthobject
SPF, DKIM and DMARC check result, or null.
domainAuthCheckedAtstring
Timestamp of the last domain check, or null.
warningsarray
Human-readable warnings, for example a failing domain record. Empty when there are none.

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