Skip to main content
GET
Get a received message

Authorizations

Authorization
string
header
required

API key with an sk_live_ or sk_test_ prefix.

Path Parameters

publicId
string
required

Public inbound message ID (e.g. rcv_...).

Response

The received message.

A received message, as returned by the message detail endpoint.

id
string

Public inbound message ID.

Example:

"rcv_0a1b2c3d4e5f6g7h"

status
enum<string>

received means the message was stored and the webhook/forward pipeline ran; dropped means it arrived on a verified inbound domain but matched no address (mail to an unknown local part); quota_exceeded means the workspace's inbound quota was hit — the full message row is still stored, but the webhook/forward pipeline was skipped.

Available options:
received,
dropped,
quota_exceeded
channel
enum<string>
Available options:
email,
sms,
push,
web-push
address
string | null

Canonical receiving address, or null for catch-all/unmatched mail.

plusTag
string | null
from
object
to
object[]
cc
object[]
envelope
object
subject
string | null
messageId
string | null

The mail's Message-ID header.

inReplyTo
string | null
text
string | null
html
string | null
strippedReply
string | null

The plain-text reply with quoted history/signature stripped.

truncated
boolean

Whether the stored body was truncated.

headers
object
attachments
object[]
verdicts
object

SES scanning verdicts (e.g. spam/virus/SPF/DKIM), as reported.

sizeBytes
integer
rawUrl
string

Authenticated API URL for the raw RFC 822 source. Same auth requirement as attachment urls.

receivedAt
string<date-time>