Skip to main content
GET
Get a message by ID

Authorizations

Authorization
string
header
required

Bearer token authentication. Include your API token in the Authorization header.

Format: Authorization: Bearer <your-token>

Path Parameters

messageId
string<uuid>
required

Unique identifier of the message to retrieve

Response

Message found and returned successfully

id
string<uuid>
required

Unique identifier for the message

chat_id
string<uuid>
required

ID of the chat this message belongs to

is_from_me
boolean
required

Whether this message was sent by the authenticated user

delivery_status
enum<string>
required

Current delivery status of a message

Available options:
sent,
delivered,
read
created_at
string<date-time>
required

When the message was created

updated_at
string<date-time>
required

When the message was last updated

is_system_message
boolean
required

Whether this timeline item is a visible Chat event.

from
string | null

Sender Relay Handle.

from_handle
object | null

The sender of this message as a full handle object

parts
object[] | null

Message parts in order (text, media, and link)

A text message part

reply_to
object | null

Indicates this message is a threaded reply to another message

sent_at
string<date-time> | null

When the message was sent

delivered_at
string<date-time> | null

When the message was delivered

read_at
string<date-time> | null

When the message was read

deliveries
object[]

Per-recipient Delivered and Read truth for direct and group Chats. Relay derives this because it controls every recipient endpoint.

system_event
object | null