Return the health checks for a mailbox: its DNS grade, whether its SPF, DMARC and MX records are valid, and the age of its sending domain.
This endpoint returns the individual checks, not an overall number. For the mailbox's overall health score from 0 to 100, use Get Health Score Points.
This response also reports how long the mailbox has been warming up, as warmup_duration_days — cumulative active warm-up time, with paused periods excluded.
Pausing warm-up does not affect this endpoint — a paused mailbox keeps returning these checks, and warmup_duration_days simply stops accumulating. Deleting the mailbox does: once it is deleted its campaignId no longer resolves and neither value is retrievable, so retrieve any history you need before you delete it.
This endpoint returns the individual health checks for a mailbox. For its overall health score from 0 to 100, use Get Health Score Points.
The checks
DNS Grade :
Your DNS Grade is based on the status of email authentication protocols and DNS records present in your account. Having the proper email infrastructure in place helps lay a solid foundation for improving email deliverability.
The grade comes from the SPF, DMARC and MX checks below. It is returned as both grade and dns_grade, which always hold the same value.
| Grade | When |
|---|---|
| A | SPF, DMARC and MX are all valid |
| C | SPF and MX are valid, but DMARC is invalid |
| D | SPF or MX is invalid, but at least one of the three records is valid |
| F | SPF, DMARC and MX are all invalid |
The grade is null when the records haven't been checked yet, or the check couldn't run.
SPF
This checks if SPF is available and valid and returns 'valid' or 'invalid' accordingly.
DMARC
This checks if DMARC is available and valid and returns 'valid' or 'invalid' accordingly.
MX
This checks if MX is available and valid and returns 'valid' or 'invalid' accordingly.
Domain Age:
Domain age is the number of days since the domain creation date. It is null when the domain's creation date isn't known.