List sessions | Vercel REST API

APIs & SDKs

List sessions

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

Retrieves a paginated list of sessions belonging to a specific sandbox. Results are sorted by creation time and paginated using an opaque cursor.

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

const response = await fetch('https://api.vercel.com/v2/sandboxes/sessions?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 sessions for.

namestringOptional

Filter sessions by sandbox name. Only sessions belonging to the specified sandbox are returned.

limitnumberOptional

Maximum number of sessions 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

200The list of sessions matching the request filters.

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

500Error

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

From the Vercel docs graph (built 2026-10-12T05:34:10.371Z), 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 session — GET /v2/sandboxes/sessions/{sessionId} — Retrieves detailed information about a specific session, including its current
List sandboxes — GET /v2/sandboxes — Retrieves a paginated list of named sandboxes belonging to a specific project. Results can be sorted
Extend session timeout — POST /v2/sandboxes/sessions/{sessionId}/extend-timeout — Extends the maximum execution time of a running session. The se
list_sessions — Use list_sessions with Vercel MCP.
List commands — GET /v2/sandboxes/sessions/{sessionId}/cmd — Retrieves a list of all commands that have been executed in a session, incl

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/sessions

const response = await fetch('https://api.vercel.com/v2/sandboxes/sessions?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