Skip to main content
GET
List Messages
Returns the account’s synced messages, newest first, filterable by conversation, direction, and time. Free, proof-signed, keyset-paginated on (sent_at, id) so a growing inbox never shifts a page.

Query

string
Restrict to one conversation.
string
inbound (the human received it) or outbound (the human, or an agent through this account, sent it).
string
ISO time. Returns only messages sent after it. direction=inbound + since is the reply watermark for a cadence engine.
string
ISO time. Returns only messages edited, read or deleted after it.
string
next_cursor from the previous page.
number
default:"50"
1–100.
boolean
default:"false"
Include messages deleted upstream (kept with deleted: true).

Response

  • source says who first stored the row: sync (a history run), webhook (real-time), or send (a reply through this account).
  • Attachments are metadata only. Download URLs are never stored, so they cannot leak. Downloading is not available in v1.
  • Edits keep only the latest text plus an edited flag. There is no edit history upstream.

Stop-on-reply pattern

Walk the whole window before you move the watermark.