messages

Get a message

Returns a single message with body, comprehension, and attachments. Requires can_read. A message in another mailbox (for a mailbox-bound key) or another account is reported as 404 (anti-enumeration).

get/api/v1/messages/{id}

Request

  • Base URL: https://postfleet.ai
  • URL: https://postfleet.ai/api/v1/messages/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

Response

Message.

idstring required
mailbox_idstring required
direction'in' | 'out' required
provider_message_idstring nullable
rfc_message_idstring nullable
thread_idstring required
in_reply_tostring nullable
from_addrstring required
to_addrstring required
subjectstring required

The sanitized subject (invisible/bidi characters stripped) — the value every delivery surface serves.

subject_rawstring nullable

Pre-sanitization subject original. Purged on the same TTL as body_raw; null on messages that predate subject sanitization. Stripped from MCP reads, like body_raw.

body_rawstring nullable
body_cleanstring nullable
truncatedboolean
created_atstring required
comprehensionobject nullable
attachmentsobject[]
spam_risk'low' | 'high' | 'error' nullable required

The layered spam verdict: 'high' from either the free SES x-ses-spam-verdict gate or the Haiku classifier reaching the same conclusion on SES-pass mail; 'low' cleared both; 'error' means the classifier failed and the message proceeded un-quarantined (availability over false quarantine). null when spam scoring never ran for this message.

virus_risk'low' | 'high' nullable required

The SES virus verdict from the free x-ses-virus-verdict gate: 'high' means SES flagged the message as malware — it is stored but never delivered (no deliver-toggle exists for malware); 'low' means SES cleared it; null when no verdict was forwarded.

Changes

No recorded changes to this operation across all 1 revision of this API.