Summarise a domain's DMARC reports
GET/api/v1/domains/:domain/reports/summary
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.
Needs the DomainsView permission.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 429
- 500
OK
The request couldn't be used. errors names each field that's wrong and why.
No API key was sent, or the key is unknown, expired or revoked.
The key's role doesn't have the permission this operation needs, or the key is limited to certain groups and this would reach outside them. detail says which.
There's no such item, or this key can't see it. A key limited to certain groups can't see what's outside them.
This key has made more requests this minute than dotMARC allows (120 by default). Wait for the number of seconds in the Retry-After header, then try again.
Something went wrong in dotMARC that the request didn't cause. It's safe to retry a read; check before retrying a change. If it keeps happening, dotMARC's logs have the details.