---
title: "Find Chat Versions"
method: GET
path: "/chats/{chatId}/versions"
tags: ["chats"]
---

# Find Chat Versions

`GET /chats/{chatId}/versions`

Retrieves a list of all versions (iterations) for a specific chat, ordered by creation date (newest first). Supports cursor-based pagination and includes version status and demo URLs.

## Path parameters

- `chatId` string, required

## Query parameters

- `limit` number — Specifies the maximum number of version records to return in a single response. Useful for paginating results when there are many versions.
- `cursor` string — Base64 encoded cursor containing pagination data

## Response `200`

Success

- object
  - `object` 'list', required
  - `data` VersionSummary[], required
    - `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.
  - `pagination` object, required
    - `hasMore` boolean, required
    - `nextCursor` string
    - `nextUrl` string

## 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` — 1 breaking, 1 warning, 2 info
  - removed the required property `meta` from the response with the `200` status
  - removed the optional property `data/items/screenshotUrl` from the response with the `200` status
  - the `data/items/createdAt` response's property pattern `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$` was removed for the status `200`
  - the `data/items/updatedAt` response's property pattern `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$` was removed for the status `200`

[Change history](https://skmtc.dev/vercel/apis/v0-platform-api-beta/changes/chats/:chatId/versions/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)