Skip to content
Docs

List sandboxes

GET/__remote/api.vercel.com/v2/sandboxes
Retrieves a paginated list of named sandboxes belonging to a specific project. Results can be sorted by creation time or name, and optionally filtered by name prefix or status. Overdue sessions for running and stopping sandboxes are recovered before returning the page, so an entry may no longer match its queried status after recovery.
Request
import { Edgenivo } from "@vercel/sdk";


const vercel = new Edgenivo({
  bearerToken: "<YOUR_BEARER_TOKEN_HERE>",
});


async function run() {
  const result = await vercel.sandboxes.listNamedSandboxes({
    project: "prj_abc123",
    teamId: "team_1a2b3c4d5e6f7g8h9i0j1k2l",
    slug: "my-team-url-slug",
  });


  console.log(result);
}


run();
Response
{
  "pagination": {
    "count": "123",
    "next": "string"
  },
  "sandboxes": [
    {
      "architecture": "amd64",
      "createdAt": "1750344501629",
      "currentSessionId": "example_id",
      "currentSnapshotId": "example_id",
      "cwd": "/vercel/sandbox",
      "expiresAt": "1750344801629",
      "failoverRegions": [],
      "image": "my-team/my-project/my-repo@sha256:2c4e8f9a1b3d5e7f091a2b3c4d5e6f708192a3b4c5d6e7f8091a2b3c4d5e6f708",
      "keepLastSnapshots": {
        "count": "5",
        "deleteEvicted": "true",
        "expiration": "604800000"
      },
      "memory": "1024",
      "mounts": "value",
      "name": "my-sandbox",
      "networkId": "example_id",
      "networkPolicy": {
        "allowedCIDRs": [],
        "allowedDomains": [],
        "deniedCIDRs": [],
        "mode": "allow-all",
        "s3Key": "string"
      },
      "persistent": "true",
      "region": "iad1",
      "runtime": "node22",
      "snapshotExpiration": "604800000",
      "status": "running",
      "statusUpdatedAt": "1750344501629",
      "tags": "[object Object]",
      "timeout": "300000",
      "totalActiveCpuDurationMs": "5000",
      "totalDurationMs": "60000",
      "totalEgressBytes": "4096",
      "totalIngressBytes": "2048",
      "updatedAt": "1750344501629",
      "vcpus": "2",
      "workloadType": "sandbox"
    }
  ]
}

Authentication

AuthorizationbearerToken

Default authentication mechanism

Query parameters

projectstringOptional
The unique identifier or name of the project to list named sandboxes for.
limitnumberOptional
Maximum number of named sandboxes to return in the response. Used for pagination.
sortBystringOptional
Field to sort by.
namePrefixstringOptional
Filter named sandboxes whose name starts with this prefix. Only valid when sortBy=name.
cursorstringOptional
Opaque pagination cursor from a previous response.
sortOrderstringOptional
Sort direction. Defaults to desc.
statusstringOptional
Filter named sandboxes by status. Only valid when sortBy is createdAt.
tagsanyOptional
Filter sandboxes by tag. Format: "key:value". Only one tag filter is supported at a 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
sandboxesarrayRequired

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
422Error
429Error