bird email tools analyze-headers
Usage
Codevoorbeeld
bird email tools analyze-headers <raw> [flags]Description
Analyze raw email headers
Analyze a raw email's headers and get back the headline fields (from, to, subject, date), the SPF/DKIM/DMARC authentication verdicts, and the full relay path with per-hop delays. The message source goes in raw, and everything from the first blank line onward (the body) is ignored. It answers why a message failed authentication, where it slowed down in transit, and what a suspicious message's headers hold. Offline: nothing is looked up or sent. Public: no authentication required.
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
Codevoorbeeld
# print the body shape (no credentials needed)
bird email tools analyze-headers --example
# the body it prints:Codevoorbeeld
{
"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 |
Related
| Name | Description |
|---|---|
| bird email tools analyze-dmarc-report | Analyze a DMARC aggregate report |
| bird email tools audit | Audit a domain's email authentication |
| bird email tools split-dns-record | Split a long DNS TXT value into 255-octet chunks |
| bird email tools validate-bimi | Validate a BIMI record |
| bird email tools validate-dmarc | Validate a DMARC record |