Search conversations
Conversations that match a ticket number, name, phone number, email address or keywords.
GET https://cotlet.dev/api/v1/trengo/conversations/search
read
Runs the inbox search and returns matches in the same shape as list_conversations. The query takes a ticket number, a contact name, a phone number, an email address, a whole email domain such as @example.com, or words from the conversation. Put a phrase in quotation marks, or set exact, to match the words in that order. Deleted tickets do not appear. Pass next_cursor back as cursor for the next page.
Parameters
| Name | Type | Description |
|---|---|---|
| query string required | string | Ticket number, name, phone number with country code, email address, domain or keywords. |
| field enum | enum | subject, ticket_number or contact_email. Default: all fields. |
| exact boolean | boolean | Only match the words in that exact order. Default: false. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl "https://cotlet.dev/api/v1/trengo/conversations/search?query=query" \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("trengo", "search_conversations", {"query":"query"})const result = await cotlet.call('trengo', 'search_conversations', {"query":"query"});cotlet call trengo search_conversations --data '{"query":"query"}'Example response
{
"conversations": [
{
"conversation_id": 5119870,
"subject": "Where is my parcel?",
"contact": "Lena Vos",
"channel": "WhatsApp",
"labels": [
"Delivery"
],
"assigned_to": "Sam de Boer",
"last_message": {
"from": "team",
"preview": "It left our warehouse on Monday and arrives tomorrow.",
"at": "2026-10-14T13:20:00Z"
}
}
],
"next_cursor": null
}