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

This endpoint behaves like GET /v1/messages/list, but accepts a richer set of message filters. 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 that decode to {"inserted_at": "<ISO8601>", "id": "<uuid>"}. Repeat the same filter parameters in the request body on every request; they are not encoded in the cursor.

Filters

In addition to the basic list filters (conversation_id, contact_id, sequence_id, campaign_id, user_id, channel_id, integration_id, type, delivery_status, after, before), search supports:

• body — partial, case-insensitive match on the message body (max 1000 characters).
• translated_body — partial, case-insensitive match on the translated message body (max 1000 characters).
• source_type — one or more message directions (INBOUND, OUTBOUND, NOTE).
• mode — one or more message modes.
• language — one or more message languages.
• translation_language — one or more translation languages.