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

# List Chats

`GET /chats`

Lists chats accessible to the authenticated user. Use metadata[key]=value style query parameters to filter by metadata.

## Query parameters

- `limit` integer
- `cursor` string
- `authorId` string
- `vercelProjectId` string
- `metadata` object

## Response `200`

Response for status 200

- object
  - `chats` object[], required — The chats in this page.
    - `id` string, required — Unique chat identifier.
    - `title` string — Chat title, if generated.
    - `privacy` 'public' | 'private' | 'team' | 'team-edit' | 'unlisted', required — Visibility setting of the chat.
    - `createdAt` string, date-time, required — ISO timestamp of when the chat was created.
    - `updatedAt` string, date-time — ISO timestamp of when the chat was last updated.
    - `authorId` string, required — ID of the user who created the chat.
    - `vercelProjectId` string — Associated Vercel project ID, if any.
    - `metadata` object, required — User-defined key-value metadata.
    - `writePermission` boolean, required — Whether the caller has write access to this chat.
  - `cursor` string, nullable, required — Cursor to fetch the next page, or null if there are no more chats.

## Other responses

- `401` — Response for status 401
- `422` — Response for status 422
- `500` — Response for status 500

## Changes

> 34 revisions in range; 5 could not be searched.

- **2026-07-30** `da68370a2aea` — 7 breaking, 4 warning, 18 info
  - for the `query` request parameter `limit`, default value was changed from `60` to `20`
  - for the `query` request parameter `limit`, the type/format was changed from `number`/`` to `integer`/``
  - removed the required property `data` from the response with the `200` status
  - removed the required property `error` from the response with the `401` status
  - …25 more
- **2026-07-21** `b53921245779` — 1 info
  - added the optional property `data/items/latestVersion/darkScreenshotUrl` to the response with the `200` status
- **2026-04-30** `670c302548ec` — 1 info
  - added the optional property `data/items/vercelProjectId` to the response with the `200` status
- **2026-03-06** `79811cd54faa` — 2 info
  - added the new optional `query` request parameter `branch`
  - added the new optional `query` request parameter `vercelProjectId`
- …earlier changes not shown

[Full 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/3cf5debd6cf4/schema)