Sign in

v1

latestOpenAPI 3.0.02026-07-26870415.2 KB
conversations

Search conversations

Find canonical conversation threads by contact identity or, when field=message, by message body text.

get/v1/conversations/search

Query parameters

workspace_idstring required

Workspace to query.

Example:j57demo8f8x7c9v0n2q4r6t8y1u3i5o
querystring required

Search value. Use names, emails, phones, or message fragments depending on field.

Example:deprano
field'any' | 'contact' | 'name' | 'first_name' | 'last_name' | 'email' | 'phone' | 'whatsapp' | 'channel' | 'message'

Conversation search scope. message searches transcript bodies; any uses the same heuristics as contact search.

Example:last_name
limitinteger
cursorstring
archived'true' | 'false'
inbox_type_idstring

Response

Conversation search results

next_cursorstring nullable required
has_moreboolean required

Example response

{
  "data": [
    {
      "id": "ph77c0dy0mgdpzmqz6tesry8w184002s",
      "workspace_id": "j57demo8f8x7c9v0n2q4r6t8y1u3i5o",
      "contact": {
        "id": "ph77c0dy0mgdpzmqz6tesry8w184002s",
        "first_name": "Jane",
        "last_name": "Doe",
        "image_url": null,
        "inbox_type_id": "guest"
      },
      "channel": "unthreaded_email",
      "archived": false,
      "ai_paused": false,
      "follow_up_at": null,
      "last_message_at": "2026-04-03T03:14:15.000Z",
      "last_message_preview": "Can I check in early?",
      "created_at": "2026-04-01T17:22:10.000Z",
      "updated_at": "2026-04-03T03:14:15.000Z"
    }
  ],
  "next_cursor": "page-token",
  "has_more": true
}