Email header analysis

POST /api/v1/header-analysis

Parses a raw email header: Received hops with time deltas, Authentication-Results (SPF/DKIM/DMARC), key sender fields and a From/Return-Path alignment hint. Body: raw header as text/plain, or JSON {“raw”: “…”}. Maximum size 64 KiB. Privacy: processing is ephemeral, nothing is stored or passed on; the response is sent with Cache-Control: no-store.

Request body

Field	Type	Required	Description
raw	string	yes	—

Responses

Status	Type	Description
200	HeaderAnalysisResult	Parsed header (Cache-Control: no-store)
400	object	Error
405	object	Error
413	object	Error
429	object	Error

Response body

Field	Type	Required	Description
api	string	no	—
hops	object[]	no	Received hops, oldest first
auth	object	no	Results from the first Authentication-Results header
fields	object	no	—
alignment	object	no	—

Example

curl -X POST "https://dns-doctor.com/api/v1/header-analysis" \
  -H "Authorization: Bearer $REGFISH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "raw": "string"
  }'

Build a request

Fill in values — the call below updates as you type. Nothing is sent: the API does not currently allow browser requests from this domain (CORS). The API key is not stored.