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. Filters combine: a domain must match every filter given. 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. Accepts the domain's id or its name, such as contoso.example.

📄️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. Accepts the domain's id or its name, such as contoso.example.

📄️Turn monitoring on or off

Whether dotMARC alerts on the domain's missing reports and DNS health. Accepts the domain's id or its name, such as contoso.example.

📄️Summarise a domain's DMARC reports

Volume, pass rate, why failing mail was let through or rejected, and the busiest sending IPs (20 by default), over the last 1 to 30 days (default 30), or any range of up to 366 days with from and to. Accepts the domain's id or its name, such as contoso.example.

📄️Set a domain's tags

Replaces the domain's tags with exactly these. Accepts the domain's id or its name, such as contoso.example.