---
name: "chat_list_conversations"
area: "chat"
title: "List chat conversations"
price: "free"
method: "POST"
url: "https://api.conecto.chat/v1/tools/chat_list_conversations"
mcp_server: "https://api.conecto.chat/mcp/chat"
auth: "Authorization: Bearer <conecto_sk_ key>"
docs_url: "https://conecto.chat/tools/chat/chat_list_conversations"
---

# List chat conversations (`chat_list_conversations`)

The website chat and email conversations, newest activity first, with who it is and the last message.

Website chat (and email) conversations, newest activity first, with who it is and the last message.

Price: Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads. A call that fails costs nothing.

## Use it when

To see which conversations are open, waiting or recently active.

- For new visitor messages as they arrive, use [chat_wait](https://conecto.chat/tools/chat/chat_wait.md).

## Say this to your agent

> Which website chats from today are still open?

## Inputs

| Name | Type | Required | Description | Allowed values | Default |
|---|---|---|---|---|---|
| `status` | string | no |  | `"open"`, `"pending"`, `"closed"`, `"any"` | `"any"` |
| `limit` | integer | no | 1 to 100. |  | `20` |
| `before` | string (date-time) | no | Only conversations active before this time, to page back. |  |  |

## Example

Written for Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon.

MCP: call `chat_list_conversations` on the MCP server `https://api.conecto.chat/mcp/chat` with these arguments:

```json
{
  "status": "open",
  "limit": 20
}
```

REST:

```bash
curl https://api.conecto.chat/v1/tools/chat_list_conversations \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status": "open", "limit": 20}'
```

## Response

```json
{
  "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93",
  "tool": "chat_list_conversations",
  "status": "succeeded",
  "replayed": false,
  "cost_usd": "$0.00",
  "balance_usd": "$19.75",
  "result": {
    "conversations": [
      {
        "conversation_id": 4101,
        "status": "open",
        "channel": "web",
        "visitor": {
          "name": "Lisa Moreno",
          "email": "lisa.moreno@example.com"
        },
        "started_at": "2026-10-14T08:00:00+00:00",
        "last_message_at": "2026-10-14T08:00:00+00:00",
        "charge": "charged",
        "last_message": {
          "from": "visitor",
          "text": "Hi! Does the Tabor ship to Seattle, and how long does it take?",
          "at": "2026-10-14T08:00:00+00:00"
        }
      }
    ],
    "count": 1
  }
}
```

`result`: Up to 100 conversations, newest activity first, each with its conversation_id, status, channel, visitor, start and last-message times, charge state and last message, and how many were listed.

## Errors

| Code | Status | When | Fix |
|---|---|---|---|
| `invalid_input` | 400 | before is not an ISO 8601 time. | Send a time like 2026-10-12T09:00:00Z. |

The refusals every tool can give (401 key, 402 balance, 429 limits) are on the errors page: https://conecto.chat/docs/errors.md

## Related

- [chat_setup](https://conecto.chat/tools/chat/chat_setup.md): Creates or changes the business's website chat widget and who answers it, and returns the snippet for the website. $0.001 a call.
- [chat_get_setup](https://conecto.chat/tools/chat/chat_get_setup.md): The website chat's settings, its embed snippet, how messages reach the agent and this month's cost. Free up to 1,000,000 reads a month.
- [chat_wait](https://conecto.chat/tools/chat/chat_wait.md): Waits for the next visitor message, for an agent without a server to receive webhooks. Free up to 1,000,000 reads a month.
- [chat_get_conversation](https://conecto.chat/tools/chat/chat_get_conversation.md): One conversation with all its messages, from the visitor and from the business. Free up to 1,000,000 reads a month.
- [chat_typing](https://conecto.chat/tools/chat/chat_typing.md): Shows the visitor that the business is typing, for about 8 seconds. Free.
- [chat_reply](https://conecto.chat/tools/chat/chat_reply.md): Answers a website visitor as the business, with product cards, images or buttons if you like. Free.
- [chat_create_ticket](https://conecto.chat/tools/chat/chat_create_ticket.md): Opens a help desk ticket from a chat that needs follow-up by email, with the chat so far as the request. $0.01 a call.
- [chat_close](https://conecto.chat/tools/chat/chat_close.md): Closes a conversation once it is handled, or opens it again. $0.001 a call.