---
title: "List or search entity conversations"
method: GET
path: "/api/v1/ackdb/entities/{entityId}/conversations"
tags: ["ackDB"]
---

# List or search entity conversations

`GET /api/v1/ackdb/entities/{entityId}/conversations`

## Request

- Base URL: `http://localhost:3009`
- URL: `http://localhost:3009/api/v1/ackdb/entities/{entityId}/conversations`
- Auth: HTTP bearer

Returns grouped, LLM-summarized conversations for an entity. When 'q' param is provided, uses hybrid semantic + keyword search. Otherwise returns filtered paginated list. Conversations group raw messages by thread (Slack thread_ts, daily digest for standalone messages).

## Path parameters

- `entityId` string, required

## Query parameters

- `q` string
- `source` string
- `topic` string
- `sentiment` 'positive' | 'negative' | 'neutral' | 'mixed'
- `hasActionItems` boolean
- `since` string, date-time
- `until` string, date-time
- `limit` integer
- `offset` integer

## Response `200`

Conversations list or search results

- object
  - `data` AckdbConversation[]
    - `id` string: ULID
    - `entityId` string
    - `source` string
    - `sourceThreadKey` string: Source-specific thread key
    - `messageCount` integer
    - `participantNames` string[]
    - `hasExternal` boolean: Whether external participants are present
    - `sourceMetadata` object: Source-specific display fields (channel_name, etc.)
    - `summary` string, nullable: LLM-generated 1-3 sentence summary
    - `topics` string[]
    - `sentiment` 'positive' | 'negative' | 'neutral' | 'mixed', nullable
    - `actionItems` string[]
    - `fileIds` string[]: IDs of entity_files attached to messages in this conversation
    - `hasFiles` boolean: Whether this conversation has file attachments
    - `firstMessageAt` string, date-time
    - `lastMessageAt` string, date-time
  - `pagination` object
    - `total` integer
    - `limit` integer
    - `offset` integer

## Other responses

- `404`: Entity not found

---

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