Messages

Get one message's full content

Marks it read as a side effect if it wasn't already.

get/v1/messages/{id}

Request

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

Path parameters

idstring uuid required

Response

OK

idstring uuid
direction'inbound' | 'outbound'
from_addressstring nullable
to_addressstring nullable
subjectstring nullable
size_bytesinteger
received_atstring date-time
read_atstring date-time nullable
deleted_atstring date-time nullable
flagged_atstring date-time nullable
folder_idstring uuid nullable
delivery_status'sent' | 'deferred' | 'bounced' | 'null' nullable

Only ever populated for direction=outbound. null means either too recent to have a result yet, or delivered locally to another Mektup mailbox rather than over external SMTP.

delivery_detailstring nullable

The real SMTP response text from the recipient's mail server (Mektup has no relayhost, so its own MTA does the delivery attempt directly) - not a synthesized summary.

delivery_checked_atstring date-time nullable
thread_keystring
textstring nullable
htmlstring nullable

Attacker-controlled content - sanitize and isolate before rendering, never render directly

Changes

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