DMARC report¶

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¶

Aggregated authentication results grouped by source.

A list, each with the settings in DMARC report record. Name in the API: records.

Errors¶

Errors encountered during report generation.

A list. Each one: text. Name in the API: errors.

Extensions¶

Custom vendor-specific extensions to the report.

A list, each with the settings in DMARC extension. Name in the API: extensions.