---
title: "List Conversations With Participants"
method: GET
path: "/api/chats/matching"
tags: ["chats"]
---

# List Conversations With Participants

`GET /api/chats/matching`

## Request

- Base URL: `https://app.thinqos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.thinqos.com/api/chats/matching`
- Auth: none declared

Conversations that already contain every one of ``participant_ids``.

TOS-4104. Backs the "you already have" section of the New chat screen, so
picking people shows the existing threads with those people instead of the
create action silently reopening one of them.

The caller's own id is dropped rather than rejected: the UI's selection
model is "who else", the caller's seat is already enforced by the query,
and 400-ing on a harmless duplicate would be a papercut with no upside.

## Query parameters

- `participant_ids` string[], required
- `limit` integer
- `offset` integer

## Headers

- `x-impersonate-identity-id` string, nullable

## Response `200`

Successful Response

- ConnectionConversationPageResponse
  - `items` ConnectionConversationResponse[], required
    - `id` string, uuid, required
    - `title` string, nullable, required
    - `container_kind` 'direct_chat' | 'topic' | 'room', required
    - `message_count` integer, required
    - `message_count_capped` boolean
    - `last_message_at` string, date-time, nullable, required
    - `last_message_preview` string, nullable, required
    - `unread_count` integer
    - `archived` boolean
    - `participants` ParticipantPreview[]
      - `identity_id` string, uuid, required
      - `display_name` string, required
      - `avatar_url` string, nullable, required
      - `kind` 'person' | 'agent' | 'org', required
    - `participant_count` integer
  - `next_offset` integer, nullable, required
  - `archived_count` integer, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/thinqos/apis/thinqos-api.md) · [All operations](https://skmtc.dev/thinqos/apis/thinqos-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thinqos/apis/thinqos-api/revisions/ce2c2ce318b1?raw)