Conversations

Search messages across all conversations for a contact

GET
/api/conversation/contact/{contactId}/messages/search

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
Length1 <= length <= 500
matchCase?boolean
Defaultfalse
wholeWord?boolean
Defaultfalse
channelType?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
Range1 <= value <= 5000
Default2000

Response 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}