List chats

Returns every chat with source: "api_chat" from workspaces authorized for the API key, without restricting results to the user who created them. It includes the same summary as List Conversations , without messages.

GET https://api.platica.mx/v1/chat

Example filtered by client:

GET https://api.platica.mx/v1/chat?clientId=client_123&limit=20

Query parameters

Parameter	Type	Description	Required
`clientId`	string	Filters chats attributed to a specific client	—
`agentId`	string	Filters by the chat's principal agent	—
`limit`	integer	Maximum number of chats to return. Maximum: `200`. Default: `50`	—
`offset`	integer	Number of chats to skip for pagination	—

Response

{
  "chats": [
    {
      "id": "conversation_doc_01JCHAT",
      "conversationId": "chat_01JCHAT23456789",
      "clientId": "client_123",
      "agentId": "agent_01JABCDEF23456789",
      "canSendDirectMessage": true,
      "workspaceId": "ws_001",
      "channelId": "workspace-ws_001-agent-agent_01JABCDEF23456789",
      "contactName": "Ana López",
      "phoneNumber": "5215512345678",
      "topic": "Plan selection",
      "platform": "platica",
      "source": "api_chat",
      "status": "active",
      "operation": "automatic",
      "messageCount": 4,
      "owners": ["sales@example.com"],
      "tags": ["prospect"],
      "creationDate": "2026-07-20T18:00:00.000Z",
      "lastUpdate": "2026-07-20T18:30:00.000Z"
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "hasMore": false
  }
}

Field	Description
`id`	Unique, canonical document ID. Use it in `GET /v1/chat/{id}` and Conversation endpoints
`conversationId`	Thread ID (`chat_*`). Each new Chat API conversation gets a distinct one; use it to continue with `POST /v1/chat`. It is not a client ID
`clientId`	Client the chat is attributed to
`agentId`	Principal agent; temporary delegation to a subagent does not change it
`canSendDirectMessage`	Always `true` for internal Platica chats
`workspaceId`	ID of the authorized workspace containing the chat
`channelId`	Internal channel ID
`contactName`	Contact/customer name
`phoneNumber`	Customer phone number, when available
`topic`	Chat topic or subject
`platform`	Platform; `platica` for these chats
`source`	Always `api_chat`
`status`	Chat status: `active`, `finished`, or `expired`
`operation`	Chat operation mode
`messageCount`	Total number of messages; the listing does not include `messages`
`owners`	List of responsible-user emails
`tags`	Associated tags
`creationDate`	Creation date in ISO 8601 format
`lastUpdate`	Last update date in ISO 8601 format

Field	Description
`limit`	Maximum number of results per page
`offset`	Number of results skipped
`hasMore`	Indicates whether more results are available

Consejo

This listing is determined by authorized workspaces and source: "api_chat", not by who created the chat. To query threads across every channel, use List Conversations .

Previous Send message to agent Next Get chat