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

# List snapshots

`GET /v2/sandboxes/snapshots`

## Request

- Base URL: `https://api.vercel.com`
- URL: `https://api.vercel.com/v2/sandboxes/snapshots`
- Auth: HTTP bearer

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
    - `pagination` object, required
      - `count` number, required
      - `next` string, nullable, required
    - `snapshots` Snapshot[], required
      - `architecture` 'amd64' | 'arm64': CPU architecture required to restore the snapshot.
      - `createdAt` number, required: The time when the snapshot was created, in milliseconds since the epoch.
      - `creationMethod` 'automatic' | 'manual': The method used to create the snapshot.
      - `expiresAt` number: The time when the snapshot will expire, in milliseconds since the epoch. If not set, the snapshot does not have any expiration.
      - `id` string, required: The unique identifier of the snapshot.
      - `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.
      - `parentId` string: The unique identifier of the parent snapshot, if this snapshot was created from another snapshot.
      - `region` string: The region where the snapshot is stored.
      - `regions` string[]: The regions where the snapshot is available.
      - `sizeBytes` number, required: The size of the snapshot in bytes.
      - `sourceSessionId` string, required: The unique identifier of the session from which the snapshot was created.
      - `status` 'created' | 'deleted' | 'failed', required: The status of the snapshot.
      - `updatedAt` number, required: The last time the snapshot was updated, in milliseconds since the epoch.
      - `workloadType` 'sandbox' | 'v0': The workload type of this snapshot.

## 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`
- `422`
- `429`

## Changes

- **2026-10-26** `01d3fe4ea5c3`: 1 warning, 1 info
  - removed the optional property `oneOf[subschema #2]/snapshots/items/v0` from the response with the `200` status
  - added the optional property `oneOf[subschema #2]/snapshots/items/workloadType` to the response with the `200` status
- **2026-10-24** `4a06e85c2848`: 1 info
  - added the non-success response with the status `422`
- **2026-10-01** `9958fd10bb05`: 1 info
  - added the optional property `oneOf[subschema #2]/snapshots/items/v0` to the response with the `200` status
- **2026-09-18** `c32b8afee578`: 1 info
  - added the optional property `oneOf[subschema #2]/snapshots/items/architecture` to the response with the `200` status
- **2026-08-21** `915cc4809c98`: 1 info
  - added the optional property `oneOf[subschema #2]/snapshots/items/regions` to the response with the `200` status

[Operation history](https://skmtc.dev/vercel/apis/vercel-api/changes/v2/sandboxes/snapshots/get.md)

---

[API](https://skmtc.dev/vercel/apis/vercel-api.md) - [All operations](https://skmtc.dev/vercel/apis/vercel-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vercel/apis/vercel-api/revisions/60686c0e1f6a?raw)