Skip to main content
GET
/
api
/
conversation
/
contact
/
{contactId}
/
messages
/
search
Search messages across all conversations for a contact
curl --request GET \
  --url https://your-instance.example.com/api/conversation/contact/{contactId}/messages/search \
  --header 'Authorization: Bearer <token>'
{
  "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
}

Documentation Index

Fetch the complete documentation index at: https://docs.tetherai.ca/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
contactId
string
required

Query Parameters

​
q
string
required
Required string length: 1 - 500
​
matchCase
boolean
default:false
​
wholeWord
boolean
default:false
​
channelType
string

Single channel or comma-separated list (e.g. "sms,email")

​
fromDate
string
Pattern: ^\d{4}-\d{2}-\d{2}$
​
toDate
string
Pattern: ^\d{4}-\d{2}-\d{2}$
​
limit
integer
default:2000
Required range: 1 <= x <= 5000

Response

Grouped search results returned

​
results
object[]
required
​
total
integer
required
​
truncated
boolean
required