The reported-mail volume series for the tenant's protected domains - how much mail receivers reported per day (or per month, past a quarter) and how much of it passed DMARC. The API twin of the Domain Protection page's volume chart and its range control.

range is 30d (default, 30 days), year (365 days) or all (13 months - the retention TTL on the aggregate slots, so there is no older data to read; RetentionMonths says so). Past 92 days the series is bucketed by month and ByMonth is true. Series keys are RAW - yyyy-MM-dd per day or yyyy-MM per month - never display labels, and every bucket in the window is present with zeroes where nothing was reported, so the axis is a calendar. Two lanes travel side by side: volume/passing across all reporters, and verifiedVolume/verifiedPassing from verified reporters only - the verified-reporter basis the page's headline uses.

Paused domains are excluded unless includePaused is true, exactly as the page's own load; domainName narrows the read to one registered domain. An empty domain set returns 200 with an empty series. The response echoes the domain set it read (Domains) and the range applied, and surfaces Truncated / TruncatedDomains (a domain has more history than one read returns) and ReadFailed (a storage read threw; the zeroes are then not evidence that nothing arrived). Nothing is written on this path.

Requires an Enterprise subscription (ErrorCode ENTERPRISE_REQUIRED; not satisfied by Professional, and get-entitlements.isEnterpriseEntitled does not imply it for partner-managed or staff-trial tenants). Admin-only read; no other paid entitlement required.