bird email tools analyze-headers

Usage

Code example

bird email tools analyze-headers <raw> [flags]

Analyze a raw email's headers for headline fields, SPF/DKIM/DMARC verdicts, and the relay path with per-hop delays. Content after the first blank line is ignored. The analysis is offline and sends no message.

Build the request from the <raw> argument, a JSON AnalyzeEmailHeadersRequest 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-headers --example

# the body it prints:

Code example

{
  "raw": "Received: from mail.example.com (mail.example.com [203.0.113.10])\n  by mx.example.net with ESMTPS id abc123\n  for <recipient@example.net>; Tue, 4 Aug 2026 09:15:22 +0000\nAuthentication-Results: mx.example.net; spf=pass smtp.mailfrom=example.com; dkim=pass header.d=example.com; dmarc=pass header.from=example.com\nFrom: Sender <sender@example.com>\nTo: recipient@example.net\nSubject: Your receipt\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-dmarc-report	Create a DMARC aggregate report 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