Reference
DMARC report
DMARC report format version.
On this page
- Organization
- Version
- Organization Name
- Contact Email
- Additional Contact Info
- Report ID
- Generator
- Reporting Period
- Period Start
- Period End
- Policy
- Policy Domain
- Policy Version
- DKIM Alignment
- SPF Alignment
- Disposition
- Subdomain Disposition
- Non-existent Subdomain Disposition
- Testing Mode
- Discovery Method
- Failure Reporting Options
- Records
- Records
- Errors
- Errors
- Extensions
- Extensions
Organization
Version
DMARC report format version.
A number. Default: 1. Name in the API: version.
Organization Name
Name of the organization that generated the report.
Text. Name in the API: orgName.
Contact Email
Contact email address of the reporting organization.
An email address. Name in the API: email.
Additional Contact Info
Additional contact information for the reporting organization.
Text. Name in the API: extraContactInfo.
Report ID
Unique identifier for this report.
Text. Name in the API: reportId.
Generator
Name and version of the software that generated the report.
Text. Name in the API: generator.
Reporting Period
Period Start
Start of the reporting period.
A date and time. Name in the API: dateRangeBegin.
Period End
End of the reporting period.
A date and time. Name in the API: dateRangeEnd.
Policy
Policy Domain
Domain for which the DMARC policy is published.
Text. Name in the API: policyDomain.
Policy Version
Version of the published DMARC policy.
Text. Name in the API: policyVersion.
DKIM Alignment
DKIM alignment mode specified in the policy.
One of: Organizational domain match is sufficient (relaxed), Exact domain match is required (strict), Alignment mode not specified (unspecified). Name in the API: policyAdkim.
SPF Alignment
SPF alignment mode specified in the policy.
One of: Organizational domain match is sufficient (relaxed), Exact domain match is required (strict), Alignment mode not specified (unspecified). Name in the API: policyAspf.
Disposition
Requested handling policy for failing messages.
One of: No specific action requested (none), Treat failing messages as suspicious (quarantine), Reject failing messages (reject), Disposition not specified (unspecified). Name in the API: policyDisposition.
Subdomain Disposition
Requested handling policy for failing messages from subdomains.
One of: No specific action requested (none), Treat failing messages as suspicious (quarantine), Reject failing messages (reject), Disposition not specified (unspecified). Name in the API: policySubdomainDisposition.
Non-existent Subdomain Disposition
Requested handling policy for failing messages from non-existent subdomains.
One of: No specific action requested (none), Treat failing messages as suspicious (quarantine), Reject failing messages (reject), Disposition not specified (unspecified). Default: Disposition not specified. Name in the API: policyNp.
Testing Mode
Whether the policy is in testing mode.
On or off. Name in the API: policyTestingMode.
Discovery Method
Method used to discover the DMARC policy record.
One of: Public Suffix List method (RFC 7489) (psl), DNS Tree Walk method (RFC 9989) (treewalk), Discovery method not specified (unspecified). Default: Discovery method not specified. Name in the API: policyDiscoveryMethod.
Failure Reporting Options
Conditions under which failure reports should be generated.
A list. Each one: one of: Generate report if all authentication mechanisms fail (all), Generate report if any authentication mechanism fails (any), Generate report if DKIM authentication fails (dkimFailure), Generate report if SPF authentication fails (spfFailure). Name in the API: policyFailureReportingOptions.
Records
Records
Aggregated authentication results grouped by source.
A list, each with the settings in DMARC report record. Name in the API: records.
Errors
Errors
Errors encountered during report generation.
A list. Each one: text. Name in the API: errors.
Extensions
Extensions
Custom vendor-specific extensions to the report.
A list, each with the settings in DMARC extension. Name in the API: extensions.