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

# Find Chats

`GET /chats`

Retrieves a list of existing chats, with support for pagination and filtering by favorite status. Helps manage and navigate chat history.

## Query parameters

- `limit` number — Specifies the maximum number of chat records to return in a single response. Useful for paginating results when there are many chats.
- `offset` number — Determines the starting point for pagination. Used in conjunction with limit to retrieve a specific page of chat results.
- `isFavorite` 'true' | 'false' — Filters chats by their "favorite" status. Accepts `"true"` or `"false"` (as strings, not booleans). - `"true"`: returns only chats marked as favorites. - `"false"`: returns only non-favorite chats.

## Response `200`

Success

- object
  - `object` 'list', required
  - `data` ChatSummary[], required
    - `id` string, required — A unique identifier for the chat.
    - `object` 'chat', required — Fixed value identifying this object as a chat.
    - `shareable` boolean, required — Indicates whether the chat can be shared via public link.
    - `privacy` 'public' | 'private' | 'team' | 'team-edit' | 'unlisted', required — Defines the visibility of the chat—private, team-only, or public.
    - `name` string — An optional name assigned to the chat by the user.
    - `title` string — Deprecated title field preserved for backward compatibility.
    - `createdAt` string, date-time, required — The ISO timestamp representing when the chat was created.
    - `updatedAt` string — The ISO timestamp of the last update to the chat.
    - `favorite` boolean, required — Indicates whether the chat is marked as a favorite.
    - `authorId` string, required — The ID of the user who created the chat.
    - `projectId` string — Optional ID of the v0 project associated with this chat.
    - `webUrl` string, required — Web URL to view this chat in the browser.
    - `apiUrl` string, required — API URL to access this chat via the API.
    - `latestVersion` object — The most recent generated version of the chat, if available.
      - `id` string, required — A unique identifier for the version.
      - `object` 'version', required — Fixed value identifying this object as a version.
      - `status` 'pending' | 'completed' | 'failed', required — The current status of the version generation process.
      - `demoUrl` string — Optional URL for previewing the generated output.
      - `createdAt` string, date-time, required — The date and time when the version was created, in ISO 8601 format.
      - `updatedAt` string, date-time — The date and time when the version was last updated, in ISO 8601 format.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `413` — Payload Too Large
- `422` — Unprocessable Entity
- `429` — Too Many Requests
- `500` — Internal Server Error

## Changes

- **2025-08-24** `3521652a43a7` — 4 warning, 3 info
  - deleted the `query` request parameter `branch`
  - deleted the `query` request parameter `vercelProjectId`
  - removed the optional property `data/items/latestVersion/screenshotUrl` from the response with the `200` status
  - removed the optional property `data/items/vercelProjectId` from the response with the `200` status
  - …3 more

[Change history](https://skmtc.dev/vercel/apis/v0-platform-api-beta/changes/chats/get.md)

---

[API](https://skmtc.dev/vercel/apis/v0-platform-api-beta.md) · [All operations](https://skmtc.dev/vercel/apis/v0-platform-api-beta/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vercel/v0-platform-api-beta/revisions/fd6d8c3bee8a/schema)