bird email tools analyze-headers
Usage
Code example
bird email tools analyze-headers <raw> [flags]Description
Create an email header analysis
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 |
Related
| 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 |
Related resources
Continue with the documentation, guides and examples for this topic. Resources are in English.
Watch the guideGetting started with emailExplore the capabilityEmailFollow the learning pathBuild your first integrationImplementation guideSend your first email
Try the practice and get an implementation brief