Visit VercelHome
v0 Platform API/Chats

Find Chats

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

GET /chats
import { v0 } from 'v0-sdk'

const result = await v0.chats.find({
  limit: '10',
  offset: '0',
  isFavorite: 'false',
})

console.log(result)
GET /chats
curl -X GET https://api.v0.dev/chats \
  -H "Authorization: Bearer $V0_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "limit": "10",
    "offset": "0",
    "isFavorite": "false"
  }'

Parameters

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 enum

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.

Possible values:

  • true
  • false

Response

Response Body

object string Required

data any[] Required

Array items: string

Create Chat

Creates a new chat using a user message, optional system context, and model configuration. Useful for prompting the model within the scope of a specific project.

Initialize Chat

Initializes a new chat from source content such as files, repositories, registries, or zip archives. Enables context-rich conversations based on code or assets.