---
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

## Changes

- **2023-06-02** `9dc94d4ca198` — 1 info
  - endpoint added
- **2022-07-21** `5384d2ef4ae9` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/wppconnect-team/apis/wppconnect-api-rest/changes/api/:session/list-chats/post.md)

---

[API](https://skmtc.dev/wppconnect-team/apis/wppconnect-api-rest.md) · [All operations](https://skmtc.dev/wppconnect-team/apis/wppconnect-api-rest/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/wppconnect-team/wppconnect-api-rest/revisions/4ae2377201e7/schema)