Conversations
Search messages across all conversations for a contact
Full-text body-field search across every conversation the caller can access for a contact. Results are grouped by conversation with matching message snippets. Supports comma-separated channelType filter and a date range. Same body-only caveat as the per-conversation search.
Authorization
bearerAuth AuthorizationBearer <token>
In: header
Path Parameters
contactId*string
Query Parameters
q*string
Length
1 <= length <= 500matchCase?boolean
Default
falsewholeWord?boolean
Default
falsechannelType?string
Single channel or comma-separated list (e.g. "sms,email")
fromDate?string
Match
^\d{4}-\d{2}-\d{2}$toDate?string
Match
^\d{4}-\d{2}-\d{2}$limit?integer
Range
1 <= value <= 5000Default
2000Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/conversation/contact/string/messages/search?q=string"{ "results": [ { "conversationId": "65d3e0f0a0b0c0d0e0f0a0b0", "channelType": "sms", "channelIdentifier": "+14155550123", "matches": [ { "messageId": "67e0a0b0c0d0e0f0a0b0c0d0", "body": "Yes please, book the demo.", "createdAt": "2026-05-18T13:30:00.000Z" } ] } ], "total": 1, "truncated": false}