---
title: "GET /api/v1/chat-message-follow-ups"
method: GET
path: "/api/v1/chat-message-follow-ups"
tags: ["Chat Message Follow-Ups"]
---

# GET /api/v1/chat-message-follow-ups

`GET /api/v1/chat-message-follow-ups`

Retrieves multiple chat message follow-ups.

## Query parameters

- `chatIds` union
  - string[]
  - string, uuid — A UUID v4 string that identifies an entity.
- `chatMessageIds` union
  - string[]
  - string, uuid — A UUID v4 string that identifies an entity.
- `pageNumber` number — The page number.
- `pageSize` number — The page size.
- `statuses` union
  - string[]
  - 'pending' | 'sent' | 'failed' | 'cancelled' — The current status of the follow-up.
- `triggerChatMessageIds` union
  - string[]
  - string, uuid — A UUID v4 string that identifies an entity.

## 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 chat message follow-ups for the specified filters.

- object[]
  - `createdAt` string, date-time, required
  - `id` string, uuid, required — A UUID v4 string that identifies an entity.
  - `updatedAt` string, date-time, required
  - `chatId` string, uuid, required — The id of the chat this follow-up belongs to.
  - `chatMessageId` string, uuid, nullable, required — The id of the chat message this follow-up belongs to.
  - `dueDate` string, date-time, required — The date and time when the follow-up message should be sent.
  - `finishedAt` string, date-time, nullable, required — The date and time when the follow-up went from pending to any other status.
  - `message` string, required — The follow-up message content.
  - `reason` string, nullable, required — The reason why the follow-up failed.
  - `status` 'pending' | 'sent' | 'failed' | 'cancelled', required — The current status of the follow-up.
  - `triggerChatMessageId` string, uuid, required — The id of the chat message that triggered the follow-up.

## 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)