---
title: "List contact conversations"
method: GET
path: "/contact/{contactId}/conversation/list"
tags: ["Contact Conversation"]
---

# List contact conversations

`GET /contact/{contactId}/conversation/list`

## Request

- Base URL: `https://api.chatbotkit.com/api/v1`
- URL: `https://api.chatbotkit.com/api/v1/contact/{contactId}/conversation/list`
- Auth: HTTP bearer

## Path parameters

- `contactId` string, required: The ID of the contact to list conversations for

## Query parameters

- `cursor` string: The cursor to use for pagination
- `order` 'asc' | 'desc': The order of the paginated items
- `take` integer: The number of items to retrieve

## Response `200`

The list of conversations was retrieved successfully

- object
  - `items` union[], required
    - union
      - object: A bot configuration that can be applied without a dedicated bot instance.
        - `name` string: The associated name
        - `description` string: The associated description
        - `meta` Meta: Meta data information
        - `id` string, required: The instance ID
        - `createdAt` number, required: The timestamp (ms) when the instance was created
        - `updatedAt` number, required: The timestamp (ms) when the instance was updated
        - `botId` string, nullable: The ID of the bot this configuration is using
        - `contactId` string: The contact id assigned to this conversation
        - `taskId` string: The task id assigned to this conversation
      - object: A bot configuration that can be applied without a dedicated bot instance.
        - `name` string: The associated name
        - `description` string: The associated description
        - `meta` Meta: Meta data information
        - `id` string, required: The instance ID
        - `createdAt` number, required: The timestamp (ms) when the instance was created
        - `updatedAt` number, required: The timestamp (ms) when the instance was updated
        - `model` string: A model definition
        - `backstory` string, nullable: The backstory this configuration is using
        - `datasetId` string, nullable: The id of the dataset this configuration is using
        - `skillsetId` string, nullable: The id of the skillset this configuration is using
        - `privacy` boolean: The privacy flag for this configuration
        - `moderation` boolean: The moderation flag for this configuration
        - `contactId` string: The contact id assigned to this conversation
        - `taskId` string: The task id assigned to this conversation
  - `cursor` string, required: Cursor for fetching the next page

## Other responses

- `default`: An error response

---

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