domain-auth
Get daily DMARC volume split by authentication outcome
GET /v1/domain-auth/domains/{domain}/timeseries
Auth required
api.domain_auth.view
Returns the domain's reported volume bucketed by day or week, split into
four disjoint alignment outcomes that sum to volume exactly: pass
(aligned on both DKIM and SPF), dkim_only (normal for forwarded mail),
spf_only, and fail (aligned on neither).
Path parameters
domain string required The domain, by NAME (acme.com). A UUID is also accepted. Matched case-insensitively, and scoped to the calling org — a domain belonging to another org is a 404, never a 403.
Query parameters
days integer optional How many days back to cover. Default 30.
interval string enum optional Bucket size. Weeks start Monday, UTC.
Responses
Errors follow the RFC 7807 problem format — see the error reference.
200 The timeseries, oldest bucket first application/json
data array<object> required Each entry in data:
date string<date> required pass integer<int64> required Aligned on BOTH DKIM and SPF.
dkim_only integer<int64> required Aligned on DKIM only — normal for forwarded mail.
spf_only integer<int64> required fail integer<int64> required Aligned on neither
volume integer<int64> required sources integer<int64> required pagination object required Fields of pagination:
has_more boolean required next_cursor string | null optional 401 Missing, malformed, or unknown API key application/problem+json
403 Key lacks the required scope or plan limit violated application/problem+json
404 Resource not found application/problem+json
422 A query parameter, path value or body field failed validation.
The body is a
validation_failed Problem. When the refusal is about a
reference — a segment key, template slug, topic or attribute name the
organization does not have — it additionally carries validation_code,
field, line/column, missing, candidates and next_step, so a
client can correct the call without a second round of guessing. See
ValidationProblem.
application/problem+json 429 Per-org rate limit exceeded application/problem+json
500 Unexpected server-side failure. The
code is internal_error. The
request_id field can be quoted to SendOps support to investigate.
application/problem+json