---
title: "List snapshots"
method: GET
path: "/v2/sandboxes/snapshots"
tags: ["sandboxes"]
---

# List snapshots

`GET /v2/sandboxes/snapshots`

Retrieves a paginated list of snapshots for a specific project.

## Query parameters

- `project` string — The unique identifier or name of the project to list snapshots for.
- `name` string — Name for the sandbox. Must be unique per project and URL-safe (alphanumeric, hyphens, underscores).
- `limit` number — Maximum number of snapshots to return in the response. Used for pagination.
- `cursor` string — Opaque pagination cursor from a previous response.
- `sortOrder` 'asc' | 'desc' — Sort direction for results by creation time.
- `teamId` string
- `slug` string

## Response `200`

- union
  - object
  - object
    - `snapshots` Snapshot[], required
      - `id` string, required — The unique identifier of the snapshot.
      - `sourceSessionId` string, required — The unique identifier of the session from which the snapshot was created.
      - `region` string — The region where the snapshot is stored.
      - `status` 'created' | 'deleted' | 'failed', required — The status of the snapshot.
      - `sizeBytes` number, required — The size of the snapshot in bytes.
      - `expiresAt` number — The time when the snapshot will expire, in milliseconds since the epoch. If not set, the snapshot does not have any expiration.
      - `createdAt` number, required — The time when the snapshot was created, in milliseconds since the epoch.
      - `updatedAt` number, required — The last time the snapshot was updated, in milliseconds since the epoch.
      - `lastUsedAt` number, required — The last time the snapshot was used (e.g. to resume or create a sandbox), in milliseconds since the epoch. Falls back to `createdAt` for older snapshots that predate this field.
      - `creationMethod` 'automatic' | 'manual' — The method used to create the snapshot.
      - `parentId` string — The unique identifier of the parent snapshot, if this snapshot was created from another snapshot.
    - `pagination` object, required
      - `count` number, required
      - `next` string, nullable, required

## Other responses

- `400` — One of the provided values in the request query is invalid.
- `401` — The request is not authorized.
- `403` — You do not have permission to access this resource.
- `404`
- `410`
- `429`

---

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