---
title: "GET /api/v1/chats"
method: GET
path: "/api/v1/chats"
tags: ["Chats"]
---

# GET /api/v1/chats

`GET /api/v1/chats`

Retrieves multiple chats.

## Query parameters

- `channelIds` union
  - string[]
  - string, uuid — A UUID v4 string that identifies an entity.
- `channelTypes` union
  - string[]
  - 'widget' | 'waha' | 'whatsapp' | 'instagram' | 'telegram' | 'api'
- `lastChatMessageCreatedAtEnd` string, date-time, nullable
- `lastChatMessageCreatedAtStart` string, date-time, nullable
- `ownerIds` union
  - string[]
  - string, uuid — A UUID v4 string that identifies an entity.
- `pageNumber` number — The page number.
- `pageSize` number — The page size.
- `responderIds` union
  - string[]
  - string, uuid — A UUID v4 string that identifies an entity.
- `responderVersionIds` union
  - string[]
  - string, uuid — A UUID v4 string that identifies an entity.
- `search` string

## Headers

- `authorization` string, required — The API key to use for authentication. Can be created in the api keys section on the workspace settings page.

## Response `200`

Retrieves all chats for the workspace.

- object[]
  - `createdAt` string, date-time, required
  - `id` string, uuid, required — A UUID v4 string that identifies an entity.
  - `isRemoved` boolean, required
  - `updatedAt` string, date-time, required
  - `channelId` string, uuid, nullable, required — A UUID v4 string that identifies an entity.
  - `currentResponderId` string, uuid, nullable, required — A UUID v4 string that identifies an entity.
  - `lastChatMessageCreatedAt` string, date-time, nullable, required
  - `ownerId` string, uuid, required — The super identity ID of the chat owner. Can refer to users.superIdentityId or externalUsers.superIdentityId.
  - `privateMemory` object, required
  - `publicMemory` object, required
  - `responderId` string, uuid, required — The super identity ID of the current chat responder. Can refer to agents.superIdentityId or squads.superIdentityId.
  - `title` string, nullable, required
  - `workspaceId` string, uuid, required — A UUID v4 string that identifies an entity.

## Other responses

- `401` — Unauthorized.

---

[API](https://skmtc.dev/zaia/apis/public-api.md) · [All operations](https://skmtc.dev/zaia/apis/public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zaia/public-api/revisions/58da3b2ba49f/schema)