---
title: "List ai chats"
method: GET
path: "/ai_chats"
tags: ["Ai chats"]
---

# List ai chats

`GET /ai_chats`

Returns a paginated list of AI chat threads for the current authenticated user.

## Query parameters

- `after` string, nullable — Returns the elements in the list that come after the specified cursor.
- `before` string, nullable — Returns the elements in the list that come before the specified cursor.
- `first` integer, nullable — Returns the first _n_ elements from the list.
- `last` integer, nullable — Returns the last _n_ elements from the list.
- `only_active_crons` boolean, nullable — When true, returns only chats with an active cron schedule

## Response `200`

A successful response

- object — The connection type for AiChat.
  - `data` AiChatListItem[], required — A list of nodes.
    - `blended_token_usage` string, required — The total number of tokens consumed across all messages in this conversation.
    - `created_at` string, date-time, required — The datetime the ai chat was created.
    - `id` string, required — The unique identifier for the ai chat.
    - `last_message_at` string, date-time, nullable, required — The timestamp of the most recent message in this conversation. Null if no messages have been sent yet.
    - `message_count` integer, required — The total number of messages exchanged in this conversation.
    - `notification_preference` 'all' | 'none', required — The notification preference for an AI chat
    - `title` string, nullable, required — A short descriptive title for this AI chat conversation. Null if no title has been set.
    - `updated_at` string, date-time, required — The datetime the ai chat was last updated.
    - `user` object, required — The user who owns this AI chat conversation.
      - `id` string, required — The unique identifier for the user.
  - `page_info` PageInfo, required — Information about pagination in a connection.
    - `end_cursor` string, nullable, required — When paginating forwards, the cursor to continue.
    - `has_next_page` boolean, required — When paginating forwards, are there more items?
    - `has_previous_page` boolean, required — When paginating backwards, are there more items?
    - `start_cursor` string, nullable, required — When paginating backwards, the cursor to continue.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `422` — Verification required
- `429` — Too many requests
- `500` — Internal server error

---

[API](https://skmtc.net/whop/apis/whop-api.md) · [All operations](https://skmtc.net/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/whop/whop-api/versions/db0883548bc5/schema)