List conversations
Find calls, WhatsApp chats and web chats. Filter by contactId (as counterpart or subject), agentId, channelId, channelType, status, conversationDirection, origin, outcome, sentiment, handling (ai or team: whether the AI takes part; escalated: handed to the team by the AI), worker (ai or team: who answers it now), the Agent's tools (toolName, toolStatus: which tool it called and how the call ended), a captured fact (factDefinition, factValue), assessment (failed or passed), toReview (what needs a person's look: not resolved, or handed to the team), length (messagesMin, messagesMax, durationMin, durationMax), campaignId, profileId, requestedBy and start time (startedAfter, startedBefore); q searches participant identities (names, profile names, usernames, phones, emails and documents), visible messages, titles, summaries and exact conversation references; count_conversations counts every match. Each item already carries its title, summary, outcome, sentiment, workers and tool calls (how many, how many failed, the latest failure), often enough to answer. sort: started (newest first), last_message (latest activity first) or changed, the feed of status, outcome and analysis changes, oldest first, that systems poll from a saved pageInfo.nextCursor (a deleted conversation appears once with deletedAt). Next: get_conversation for a transcript.
- Scopes: any one of
raiz:conversations:read,raiz:conversations:write - Credentials: an API key, a client-credentials token or a person's access token
- Effect: read-only; safe to retry
- Limits: response up to 1 MB
- CLI:
arbol raiz conversations list· MCP tool:raiz_conversations_list
https://api.getarbol.com/v1/raiz/conversationsAuthorization
Query parameters
- handlingoptionalaiorteamorescalated
ai: conversations the AI takes part in (calls and web chats, and WhatsApp conversations the AI handles or answered).team: WhatsApp conversations the organization's people handle on their own.escalated: conversations the AI handed to the team (a request it could not resolve, a contact who asked for a person, or a spent budget), also once the team gave them back to the AI; the onesconversations_dailycounts inescalatedCount. A trial is not one, nor a conversation that opens while the AI is still paused for the number after an earlier handoff. - workeroptionalaiorteam
Who works the conversation now.
ai: calls and web chats, open WhatsApp conversations the AI answers (assigned to it and not paused), and closed ones the AI answered.team: open WhatsApp conversations the organization's people answer (not assigned to the AI, or paused) and closed ones they answered. Unlikehandling, a conversation the AI answered and then handed to people isteamwhile open. - qoptionalstring
Search participant names, channel profile names, usernames, phones, emails, identity documents, visible message text, conversation ids and exact external references. Ignores accents/case and phone/document formatting. Also searches titles and summaries with Spanish stemming (quoted phrases,
orand-wordapply there). Attachments without stored transcription and tool payloads are not searched.maxLength: 200 · minLength: 1 - sortoptionalstartedorlast_messageorchanged
started(newest first),last_message(most recent activity first) orchanged: the changed feed, oldest change first, with deleted conversations as tombstones; a forward page'spageInfo.nextCursoris always a position to save and poll from.default: "started"
Returns
200
Successful operation.
400
INVALID_INPUT: The request does not match the published schema.INVALID_CURSOR: The cursor is malformed or belongs to a different list.
502
OUTCOME_UNKNOWN: The operation may have been applied; check its result before repeating it.
503
UPSTREAM_UNAVAILABLE: The upstream service could not complete the request.INTEGRATIONS_UNAVAILABLE: The organization's integrations cannot be read right now. Try again shortly.