bird email tools analyze-dmarc-report

Usage

Code example

bird email tools analyze-dmarc-report <report-xml> [flags]

Description

Create a DMARC aggregate report analysis

Analyze a DMARC aggregate report supplied as report_xml. Returns totals, per-source-IP SPF and DKIM alignment results, and actionable findings. The analysis is offline and sends no message.

Build the request from the <report_xml> argument, a JSON AnalyzeDmarcReportRequest body via --body-file ("-" reads stdin), or both — an inline value overrides the matching body field. Run --example to print a ready-to-edit body, or --dry-run to print the resolved request without sending it.

Examples

Code example

# print the body shape (no credentials needed)
bird email tools analyze-dmarc-report --example

# the body it prints:

Code example

{
  "report_xml": "<feedback>\n  <report_metadata>\n    <org_name>example.net</org_name>\n    <report_id>14297523</report_id>\n  </report_metadata>\n  <policy_published>\n    <domain>example.com</domain>\n    <p>none</p>\n  </policy_published>\n  <record>\n    <row>\n      <source_ip>203.0.113.10</source_ip>\n      <count>42</count>\n      <policy_evaluated><disposition>none</disposition><dkim>pass</dkim><spf>pass</spf></policy_evaluated>\n    </row>\n  </record>\n</feedback>\n"
}

Options

Request

Name	Description
--body-file	Read the JSON request body from this file; "-" reads stdin
--example	Print a complete example request body, then exit
--dry-run	Print the resolved request without sending it, then exit
--idempotency-key	Deduplication key; a retry with the same key won't act twice

Options

Name	Description
--response-schema	Print the fields this command returns, then exit

Name	Description
bird email tools analyze-headers	Create an email header analysis
bird email tools audit	Get a domain email-authentication audit
bird email tools split-dns-record	Get chunks for a long DNS TXT value
bird email tools validate-bimi	Get BIMI record validation results
bird email tools validate-dmarc	Get DMARC record validation results