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

# List sessions

`GET /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.

## Query parameters

- `project` string — The unique identifier or name of the project to list sessions for.
- `name` string — Filter sessions by sandbox name. Only sessions belonging to the specified sandbox are returned.
- `limit` number — Maximum number of sessions 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`

The list of sessions matching the request filters.

- union
  - object
  - object
    - `sessions` Session[], required
      - `sourceSandboxName` string, required — The name of the source sandbox.
      - `projectId` string, required — The unique identifier of the project associated with this session.
      - `id` string, required — The unique identifier of the sandbox.
      - `memory` number, required — Memory allocated to this sandbox in MB.
      - `vcpus` number, required — Number of vCPUs allocated to this sandbox.
      - `region` string, required — The region where the sandbox is hosted.
      - `runtime` string, required — The runtime of the sandbox.
      - `timeout` number, required — The maximum amount of time the sandbox will run for in milliseconds.
      - `status` 'aborted' | 'failed' | 'pending' | 'running' | 'snapshotting' | 'stopped' | 'stopping', required — The status of the sandbox.
      - `requestedAt` number, required — The time when the sandbox was requested, in milliseconds since the epoch.
      - `startedAt` number — The time when the sandbox was started, in milliseconds since the epoch.
      - `cwd` string, required — The working directory of the sandbox.
      - `requestedStopAt` number — The time when the sandbox was requested to stop, in milliseconds since the epoch.
      - `stoppedAt` number — The time when the sandbox was stopped, in milliseconds since the epoch.
      - `abortedAt` number — The time when the sandbox was aborted, in milliseconds since the epoch.
      - `duration` number — The duration of the sandbox in milliseconds.
      - `sourceSnapshotId` string — The unique identifier of the snapshot associated with this sandbox, if any.
      - `snapshottedAt` number — The time when a snapshot was requested, in milliseconds since the epoch.
      - `createdAt` number, required — The time when the sandbox was created, in milliseconds since the epoch.
      - `updatedAt` number, required — The last time the sandbox was updated, in milliseconds since the epoch.
      - `networkPolicy` SandboxNetworkPolicy — The network policy applied to this sandbox, if any.
        - `mode` 'allow-all' | 'custom' | 'deny-all', required — The network policy mode. - 'allow-all': All traffic is allowed. - 'deny-all': All traffic is blocked. - 'custom': Traffic is controlled by explicit allow/deny rules.
        - `allowedDomains` string[] — List of domain names the sandbox is allowed to connect to. Supports wildcard patterns (e.g., "*.vercel.com" matches all subdomains).
        - `allowedCIDRs` string[] — List of IP address ranges (in CIDR notation) the sandbox is allowed to connect to.
        - `deniedCIDRs` string[] — List of IP address ranges (in CIDR notation) the sandbox is blocked from connecting to. These rules take precedence over all allowed rules.
        - `injectionRules` SandboxInjectionRule[] — HTTP header injection rules for outgoing requests matching specific domains.
          - `domain` string, required — The domain (or pattern) that this injection rule applies to. Supports wildcards like *.vercel.com.
          - `headerNames` string[] — The names of HTTP headers that have value that will be injected for requests to this domain.
      - `activeCpuDurationMs` number — The amount of CPU time the sandbox consumed, if available, in milliseconds. This value is only available once the sandbox is stopped, and only if it stopped successfully.
      - `networkTransfer` object — The quantity of data transfered to and from the sandbox, in bytes. This value is only available once the sandbox is stopped, and only if it stopped successfully.
        - `ingress` number, required
        - `egress` number, required
    - `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`
- `500`

---

[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)