List snapshots | Vercel REST API

APIs & SDKs

List snapshots

GEThttps://api.vercel.com/v2/sandboxes/snapshots

Retrieves a paginated list of snapshots for a specific project.

https://api.vercel.com/v2/sandboxes/snapshots

const response = await fetch('https://api.vercel.com/v2/sandboxes/snapshots?project=string&name=string&limit=123&cursor=string&sortOrder=string&teamId=string&slug=string', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
});

const data = await response.json();
console.log(data);

Response

"value"

Authentication

AuthorizationbearerToken

Default authentication mechanism

Query parameters

projectstringOptional

The unique identifier or name of the project to list snapshots for.

namestringOptional

Name for the sandbox. Must be unique per project and URL-safe (alphanumeric, hyphens, underscores).

limitnumberOptional

Maximum number of snapshots to return in the response. Used for pagination.

cursorstringOptional

Opaque pagination cursor from a previous response.

sortOrderstringOptional

Sort direction for results by creation time.

teamIdstringOptional

The Team identifier to perform the request on behalf of.

slugstringOptional

The Team slug to perform the request on behalf of.

Response

200Success

Errors

400One of the provided values in the request query is invalid.

401The request is not authorized.

403You do not have permission to access this resource.

404Error

410Error

429Error

Cross-link map: List snapshots (/docs/rest-api/sandboxes/list-snapshots)

From the Vercel docs graph (built 2026-10-13T05:35:52.211Z), spanning vercel.com docs + KB, nextjs.org, ai-sdk.dev, and other Vercel documentation sites. Full graph as JSON: https://vercel.com/docs/graph.json

Semantically closest pages

Get a snapshot — GET /v2/sandboxes/snapshots/{snapshotId} — Retrieves detailed information about a specific snapshot, including its creat
Create a snapshot — POST /v2/sandboxes/sessions/{sessionId}/snapshot — Creates a point-in-time snapshot of a running session's filesystem. S
Delete a snapshot — DELETE /v2/sandboxes/snapshots/{snapshotId} — Permanently deletes a snapshot and frees its associated storage. This acti
List sandboxes — GET /v2/sandboxes — Retrieves a paginated list of named sandboxes belonging to a specific project. Results can be sorted
List sessions — GET /v2/sandboxes/sessions — Retrieves a paginated list of sessions belonging to a specific sandbox. Results are sorted

This page links to (1)

Vercel REST API Reference — Interact programmatically with your Vercel account using the SDK or direct HTTP requests.

Pages that link here (1)

By site: vercel-docs (1)

Vercel REST API Reference — Interact programmatically with your Vercel account using the SDK or direct HTTP requests.

https://api.vercel.com/v2/sandboxes/snapshots

const response = await fetch('https://api.vercel.com/v2/sandboxes/snapshots?project=string&name=string&limit=123&cursor=string&sortOrder=string&teamId=string&slug=string', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
});

const data = await response.json();
console.log(data);

Response

"value"

OpenAPI Specification