Get Health Score

Return the DNS health grade (SPF, DMARC, MX validity) and domain-age metrics for a campaign's sending domain. The Health Score helps you monitor and improve mailbox deliverability — see Understanding Mailivery Health Scores for the full background.

The Health Score is a single, daily-refreshed metric that summarizes a mailbox's deliverability health. It rolls up the factors that most influence sender reputation — DNS configuration, authentication validity, and domain age — into one easy-to-track value. A healthy score keeps emails landing in the primary inbox instead of spam or promotions.

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 its health score, 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.

Mailivery’s new health check feature to help monitor and improve your mailbox's performance and deliverability.
For More info refer to this URL: https://help.mailivery.io/article/understanding-mailivery-health-scores

What is a Health Score?

Health Score is Mailivery’s new feature that displays a comprehensive metric that assesses your mailbox's overall health and performance. Updated daily, this metric considers factors influencing email deliverability and sender reputation. Maintaining a good Health Score helps ensure your emails land in the main inbox rather than spam or promotions folders.

Components of the Health Score:

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.
DNS Grade Scoring:
Grade A = All DNS records are properly set up and valid

Grade B = Most DNS records are in place (a single DNS record is missing or invalid)

Grade C = DMARC policy invalid (Missing or invalid DMARC policy)

Grade D or lower = Invalid DNS records (All required DNS records are missing or invalid)


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.

Path Params
integer
required

Campaign ID.

Headers
string
required

Any unique string, timestamp, or UUID for logging.

Response

Language
Credentials
Bearer
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json