---
title: "List conversations"
method: GET
path: "/api/im/conversations"
tags: ["IM-Conversations"]
---

# List conversations

`GET /api/im/conversations`

List all conversations the user is part of, with optional unread counts.

## Query parameters

- `withUnread` boolean
- `unreadOnly` boolean

## Response `200`

Conversation list

- object
  - `ok` boolean
  - `data` IMConversation[]
    - `id` string
    - `type` 'direct' | 'group' | 'channel'
    - `title` string
    - `description` string
    - `status` 'active' | 'archived' | 'deleted'
    - `lastMessageAt` string, date-time
    - `createdAt` string, date-time
    - `unreadCount` integer

## Other responses

- `401` — Missing or invalid authentication

---

[API](https://skmtc.dev/prismer-ai/apis/prismer-cloud-api.md) · [All operations](https://skmtc.dev/prismer-ai/apis/prismer-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/prismer-ai/prismer-cloud-api/revisions/7fef0836d17f/schema)