Domains

List domains with their DNS health and DMARC report summaries, add a domain, and set its groups, tags and monitoring.

📄️List domains

Domains this key can see, in dashboard order, 50 a page by default and at most 200. Filter by group id, tag id or monitoring. The pass rate covers the last 30 days and is null with no reports.

📄️Add a domain

Adds a domain for dotMARC to monitor. It shows as missing reports until its first DMARC report arrives.

📄️Get a domain and its health

The domain with the results of dotMARC's last DNS checks. The API never runs checks itself; checkedUtc says when each last ran.

📄️Set a domain's groups

Replaces the domain's groups with exactly these. A key limited to certain groups can only name its own groups, and the domain keeps any groups outside them.

📄️Turn monitoring on or off

Whether dotMARC alerts on the domain's missing reports and DNS health.

📄️Summarise a domain's DMARC reports

Volume, pass rate, why failing mail was let through or rejected, and the 20 busiest sending IPs, over the last 1 to 30 days (default 30).

📄️Set a domain's tags

Replaces the domain's tags with exactly these.