Lists messages for an organization using bidirectional cursor pagination (oldest first).

Messages are sorted by inserted_at ascending, with id as a tiebreaker.

Pagination

• First page: omit cursor (or use direction=forward, the default).
• Next page (newer messages): use metadata.next_cursor with direction=forward.
• Previous page (older messages): use metadata.prev_cursor with direction=backward.
• direction=backward without cursor: returns 422.
• offset: not supported.

Cursors are opaque, base64-encoded tokens. Each cursor references a page boundary row: next_cursor is the last row on the page; prev_cursor is the first row. Both directions use exclusive boundaries, so rows are not duplicated across pages.

The cursor decodes to {"inserted_at": "<ISO8601>", "id": "<uuid>"}.

Repeat the same filter query parameters on every request; they are not encoded in the cursor.

Filters

Optional query filters: conversation_id, contact_id, sequence_id, campaign_id, user_id, channel_id, integration_id, type, delivery_status, after, before.