GET
cURL
Returns a conversation and its messages, oldest first, including each message’s attachments. Reading a conversation does not mark it read; use Update a thread for that. Very long message bodies are cut short in the response rather than refused. Download attachments with Download an attachment.
Needs an API key with full access. A conversation outside the key’s team or domain returns 404.

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string
required
Required string length: 1 - 64
Pattern: ^[A-Za-z0-9_-]+$
Example:

"cm9abc123"

Response

200 - application/json

The thread and its latest 100 non-draft messages, oldest first. Reading does not mark anything read.

id
string
required
mailbox_id
string
required
subject
string
required
from
object
required
snippet
string
required
folder
string
required

Folder of the latest matching message: inbox, sent, drafts, spam, archive, trash or custom

unread
boolean
required
message_count
integer
required
last_message_at
string<date-time>
required
last_direction
enum<string>
required
Available options:
inbound,
outbound
messages
object[]
required