Messages

Retrieve message

Retrieve a specific message by its ID. By default, the response includes the parsed Nodemailer object and raw message content. You can control what's included using query parameters.

get/v1/messages/{id}

Request

Base URL: https://api.forwardemail.net
URL: https://api.forwardemail.net/v1/messages/{id}
Auth: HTTP basic

Path parameters

idstring required

Message ID

Query parameters

emlboolean

Return raw EML format instead of JSON

nodemailerboolean

Include parsed Nodemailer object

attachmentsboolean

Include attachments in Nodemailer object

rawboolean

Include raw message content

Response

Message retrieved successfully

idstring required

Message ID

root_idstring required

Root message ID for threading

folder_idstring required

Folder ID containing the message

folder_pathstring required

Folder path containing the message

thread_idstring required

Thread ID for conversation grouping

header_message_idstring required

Message-ID header value

is_unreadboolean required

Whether message is unread

is_flaggedboolean required

Whether message is flagged

is_deletedboolean required

Whether message is deleted

is_draftboolean required

Whether message is a draft

is_junkboolean required

Whether message is junk/spam

is_copiedboolean required

Whether message is copied

is_encryptedboolean required

Whether message is encrypted (PGP/MIME or S/MIME)

is_searchableboolean required

Whether message is searchable

is_expiredboolean required

Whether message is expired

has_attachmentboolean required

Whether message has attachments

retention_datestring date-time nullable required

Message retention date

internal_datestring date-time required

Internal date (IMAP)

header_datestring date-time required

Date from message headers

subjectstring required

Message subject

flagsstring[] required

IMAP flags

labelsstring[] required

User-defined labels (lowercase, max 10)

sizeinteger required

Message size in bytes

uidinteger required

IMAP UID

modseqinteger required

Modification sequence

transactionstring required

Transaction type

remote_addressstring required

Remote IP address

created_atstring date-time required

Message creation timestamp

updated_atstring date-time required

Message last update timestamp

nodemailerobject

Parsed message object (included by default, set ?nodemailer=false to exclude)

rawstring

Raw message content (included by default, set ?raw=false to exclude)

object'message' required

Example response

{
  "id": "message123",
  "root_id": "root123",
  "folder_id": "folder123",
  "folder_path": "INBOX",
  "thread_id": "thread123",
  "header_message_id": "<message123@example.com>",
  "is_unread": true,
  "is_flagged": false,
  "is_deleted": false,
  "is_draft": false,
  "is_junk": false,
  "is_copied": false,
  "is_encrypted": false,
  "is_searchable": true,
  "is_expired": false,
  "has_attachment": false,
  "retention_date": null,
  "internal_date": "2025-01-01T00:00:00.000Z",
  "header_date": "2025-01-01T00:00:00.000Z",
  "subject": "Test Message",
  "flags": [
    "\\Seen"
  ],
  "size": 1024,
  "uid": 1,
  "modseq": 1,
  "transaction": "API",
  "remote_address": "127.0.0.1",
  "created_at": "2025-01-01T00:00:00.000Z",
  "updated_at": "2025-01-01T00:00:00.000Z",
  "object": "message"
}

Changes

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