---
title: "List Chats"
method: GET
path: "/chats"
tags: ["Chat"]
---

# List Chats

`GET /chats`

Returns a paginated list of chats with optional filters. Org-level API keys return all chats; user-level keys return only chats accessible to the user.

## Query parameters

- `filter[external_id]` string
- `filter[type]` 'chat' | 'email'
- `filter[title]` string
- `filter[participant_name]` string
- `filter[scorecard_id]` string[]
- `filter[user_id]` string[]
- `filter[team_id]` string[]
- `from_date_time` string, date-time
- `to_date_time` string, date-time
- `exclude_transcript` boolean
- `page` integer
- `size` integer

## Response `200`

Chats successfully returned

- ListChatsResponse
  - `data` Chat[]
    - `id` string — Unique identifier of the chat
    - `externalId` string — External identifier from the source system
    - `applicationName` string — Name of the application that created the chat
    - `title` string — Title of the chat
    - `type` 'chat' | 'email' — Type of chat (chat or email)
    - `userId` string — UUID of the user who owns the chat
    - `teamId` string — UUID of the team the chat belongs to
    - `participants` ChatParticipant[] — List of chat participants
      - `externalId` string — External identifier of the participant
      - `name` string — Display name of the participant
      - `email` string — Email address of the participant
      - `participantType` 'prospect' | 'user' | 'bot' — Type of participant
      - `userUuid` string — UUID of the associated user (if applicable)
    - `transcript` ChatTranscriptItem[] — Chat transcript entries (omitted when exclude_transcript=true)
      - `sentence` string — The text content of the transcript entry
      - `author` string — Name of the author
      - `authorEmail` string — Email address of the author
      - `datetime` string, date-time — Timestamp of the transcript entry
    - `dateStart` string, date-time — When the chat started
    - `createdAt` string, date-time — When the chat record was created
  - `meta` Meta
    - `pageCount` integer
    - `totalRecords` integer
    - `pageNumber` integer
    - `pageSize` integer

## Other responses

- `401` — Valid API key required
- `default` — Unexpected error

---

[API](https://skmtc.net/attention/apis/attention-service-v2.md) · [All operations](https://skmtc.net/attention/apis/attention-service-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/attention/attention-service-v2/revisions/5de55d3804cf/schema)