List chats

Summaries of the chats you can see, newest first by default: each with its latest thread, the last event of each type and the people in it.

A bot sees only chats assigned to it. filters.active keeps open (or closed) chats, filters.group_ids chats in those groups. Pages carry the first request's filters in page_id, so send nothing else with it.

POST/v1/agent/action/list_chats

List chats

curl -X POST 'https://app.staging.mlive.chat/v1/agent/action/list_chats' \
  -H "Authorization: Bearer $MLC_BOT_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{}'

const res = await fetch('https://app.staging.mlive.chat/v1/agent/action/list_chats', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.MLC_BOT_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
});
const data = await res.json();

Response200

{
  "chats_summary": [
    {
      "id": "828aec20-b9c3-7700-80fb-c1e028342cc0",
      "last_event_per_type": {},
      "users": [
        {
          "id": "828aec20-b9c3-7700-80fb-c1e028342cc0",
          "type": "customer",
          "name": "Nadia Rahman",
          "email": "nadia@shop.northwind.example",
          "present": true,
          "avatar": "avatar",
          "visibility": "visibility",
          "created_at": "2026-11-13T09:30:00Z",
          "session_fields": [
            {}
          ]
        }
      ],
      "last_thread_summary": {
        "id": "828aec20-b9c3-7700-80fb-c1e028342cc0",
        "created_at": "2026-11-13T09:30:00Z",
        "user_ids": [
          "749389f6-853a-76d0-85e2-43aaa689a084"
        ],
        "properties": {},
        "active": true,
        "access": {
          "group_ids": [
            0
          ]
        }
      },
      "properties": {},
      "access": {
        "group_ids": [
          0
        ]
      },
      "is_followed": true
    }
  ],
  "found_chats": 3,
  "next_page_id": "MjAyNi0xMS0xM1QwOTozMDowMFo",
  "previous_page_id": "316fbd3a-387f-73b0-8f8f-aa26469fa09c"
}

Specifics

Method URL	`POST https://app.staging.mlive.chat/v1/agent/action/list_chats`
Who can call it	Bots, with a bot token (`mlcb_`).

Request body

application/json

filtersobject
filters.activeboolean or null
filters.group_idsarray of integer
Up to 200 items.
filters.include_chats_without_threadsboolean
sort_orderstring
One of asc, desc. Default "desc".
limitinteger
1 to 100. Default 10.
page_idstring

Response

200 · application/json

OK.

chats_summaryarray of LCChatSummaryrequired
found_chatsintegerrequired
next_page_idstring
Only when there is a next page.
previous_page_idstring
Only when there is a previous page.

Errors

default