---
title: "Retrieve a list of chats"
method: POST
path: "/api/{session}/list-chats"
tags: ["Chat"]
---

# Retrieve a list of chats

`POST /api/{session}/list-chats`

This body is not required. Not sent body to get all chats or filter.

## Path parameters

- `session` string, required

## Request body

- object
  - `id` string
  - `count` number
  - `direction` string
  - `onlyGroups` boolean
  - `onlyUsers` boolean
  - `onlyWithUnreadMessage` boolean
  - `withLabels` unknown[]
    - unknown

## Response `200`

OK

## Other responses

- `500` — Internal Server Error

---

[API](https://skmtc.net/wppconnect-team/apis/wppconnect-api-rest.md) · [All operations](https://skmtc.net/wppconnect-team/apis/wppconnect-api-rest/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wppconnect-team/wppconnect-api-rest/versions/9b4f8efc1a6b/schema)