---
title: "Get list of sandboxes"
method: GET
path: "/api/sandboxes"
tags: ["Sandboxes"]
---

# Get list of sandboxes

`GET /api/sandboxes`

## Query parameters

- `page` integer
- `limit` integer
- `status` 'active' | 'closed' | 'close-error' | 'error' — Current sandbox lifecycle status.
- `start` number
- `end` number
- `search` string

## Response `200`

Paginated list of sandboxes

- SandboxListResponse
  - `sandboxes` Sandbox[], required
    - `id` string, uuid, required
    - `teamId` string
    - `status` 'active' | 'closed' | 'close-error' | 'error', required — Current sandbox lifecycle status.
    - `startTime` number, nullable — Start timestamp in epoch milliseconds.
    - `endTime` number, nullable — End timestamp in epoch milliseconds.
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `closeReason` string, nullable
    - `creditsUsed` number, nullable
    - `region` 'us' | 'us-central' | 'us-west' | 'us-east' | 'asia-south' | 'europe-west', required
    - `vcpus` integer, nullable
    - `memMiB` integer, nullable
    - `diskSizeMiB` integer, nullable
    - `timeoutMinutes` integer, nullable
    - `network` SandboxNetworkPolicy — Effective outbound network policy for a sandbox.
      - `allowInternetAccess` boolean, required — Whether general outbound internet access is allowed.
      - `allowOut` string[], required — Outbound allow rules. Each entry is an IPv4 address, CIDR range, or domain.
      - `denyOut` string[], required — Outbound deny rules. Each entry is an IPv4 address or CIDR range.
    - `sessionUrl` string — Dashboard URL for this sandbox.
    - `duration` number — Total runtime in milliseconds (0 while running).
    - `proxyBytesUsed` number
    - `runtime` SandboxRuntimeTarget, required — Connection details for the sandbox runtime API (process execution, files, terminals).
      - `transport` 'regional_proxy', required
      - `host` string, required — Regional runtime origin.
      - `baseUrl` string, required — Base URL for runtime API requests for this sandbox.
    - `exposedPorts` SandboxExposedPort[], required
      - `port` integer, required
      - `auth` boolean, required — Whether requests to the exposed URL require authentication.
      - `url` string, required — Public URL that routes to the exposed port.
      - `browserUrl` string — URL that bootstraps browser access. For authenticated ports this includes a short-lived grant token.
      - `browserUrlExpiresAt` string, date-time, nullable — Expiry of the browser bootstrap grant, if auth is enabled.
  - `totalCount` integer, required
  - `page` integer, required
  - `perPage` integer, required

## Changes

> 5 revisions in range; 2 could not be searched.

- **2026-08-06** `69aa004ce41b` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/hyperbrowser/apis/hyperbrowser-api/changes/api/sandboxes/get.md)

---

[API](https://skmtc.dev/hyperbrowser/apis/hyperbrowser-api.md) · [All operations](https://skmtc.dev/hyperbrowser/apis/hyperbrowser-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hyperbrowser/hyperbrowser-api/revisions/9d8b355ebbf2/schema)