/v1/workspaces/{workspace_id}/mailboxes/{id}/messages/{mid}AuthGet a single message (metadata + attachment manifest; `body_preview` is null without `mail.message.body.read`). Use /:mid/raw for content.
Path parameters
workspace_id*string · uuidId of the workspace.
id*string · uuidId of the mailboxe.
mid*string · uuidId of the message in the mailbox.
Response · 200
id*string · uuidThe message id.
mailbox_id*string · uuidThe mailbox the message was delivered to.
seq_id*stringSequential ID per mailbox.
Example: "42"
raw_object_key*stringStorage object key for the raw RFC5322 .eml.
envelope_to*stringThe SMTP envelope recipient.
from_address*stringSender address from the From header.
from_local*stringPart of the sender address before the @.
from_domain*stringDomain of the sender address.
to_addresses*arrayAddresses from the To header.
cc_addresses*arrayAddresses from the Cc header.
subject*stringSubject line; null when the message has none.
body_preview*stringFirst 512 bytes of the plaintext body. This is message content, not metadata, so it is only populated for callers holding `mail.message.body.read`; everyone else sees null. The full body is at /:mid/raw, behind the same action.
rfc822_message_id*stringThe Message-ID header; null when missing.
size_bytes*numberSize of the raw message in bytes.
spam_score*stringSpam score from the receiving filter; null when not scored.
spam_verdict*stringSpam verdict from the receiving filter; null when not scored.
spf_result*stringSPF result for the sender; null when not checked.
dkim_result*stringDKIM result; null when not checked.
dmarc_result*stringDMARC result; null when not checked.
quarantined*booleanTrue when the message was quarantined as spam or malware.
received_at*string · date-timeWhen the message arrived.
read_at*string · date-timeWhen the message was marked read; null while unread.
deleted_at*string · date-timeWhen the message was deleted; null while not deleted.
attachments*arrayThe message's attachments.
Example
Request
GET https://api.mail.productcraft.co/v1/workspaces/{workspace_id}/mailboxes/{id}/messages/{mid}
Authorization: Bearer YOUR_TOKENResponse
{
"id": "00000000-0000-0000-0000-000000000000",
"mailbox_id": "00000000-0000-0000-0000-000000000000",
"seq_id": "42",
"raw_object_key": "string",
"envelope_to": "string",
"from_address": "string",
"from_local": "string",
"from_domain": "string",
"to_addresses": [
"string"
],
"cc_addresses": [
"string"
],
"subject": "string",
"body_preview": "string",
"rfc822_message_id": "string",
"size_bytes": 0,
"spam_score": "string",
"spam_verdict": "string",
"spf_result": "string",
"dkim_result": "string",
"dmarc_result": "string",
"quarantined": false,
"received_at": "2026-01-01T00:00:00.000Z",
"read_at": "2026-01-01T00:00:00.000Z",
"deleted_at": "2026-01-01T00:00:00.000Z",
"attachments": [
{
"position": 0,
"filename": "string",
"content_id": "string",
"content_type": "string",
"size_bytes": 0,
"sha256": "string"
}
]
}