Skip to navigation
FreeCustom.Email APIV1InboxesInboxMessagesID

Get a message

View as Markdown

Retrieves the full content of a single message by its ID, including HTML body, plain-text body, headers, metadata, and any attachments.

Path parameters:

  • :inbox — URL-encoded inbox address (e.g., test%40domain.com)
  • :id — Message ID returned by GET /v1/inboxes/:inbox/messages

Response fields:

  • id — Unique message identifier
  • from — Sender address
  • subject — Email subject line
  • html — Full HTML body
  • text — Plain-text body
  • receivedAt — ISO 8601 timestamp
  • attachments — Array of attachment objects (name, size, mimeType, url); availability depends on plan
  • otp — Extracted OTP value if detected ("__DETECTED__" on plans below Growth)

Plan: All plans. Attachment access requires Developer plan or higher. OTP value requires Growth plan or higher.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

inboxstringRequired
idstringRequired

Response

OK
successboolean
dataobject

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error