Skip to main content
GET
List messages
List messages for your workspace, optionally filtered to a conversation. Scope: comms_read

Request

Query parameters

string
Only return messages in this conversation.
string
Lower bound timestamp (ISO-8601 when provided).
string
Filter by message direction when supported by your deployment.
integer
Maximum number of messages to return. Must be a positive integer.

Response

line_e164 is your number on that thread (the inbound to, or the number you sent from). Use it as the tenant discriminator when a workspace owns more than one dedicated line. line_id is the provider id when known. Both fields are omitted when the line was never recorded.

Errors

See also