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

# List sandboxes

`GET /sandboxes`

## Query parameters

- `limit` integer
- `status` string
- `page_token` string

## Response `200`

OK

- ThundertypesSandboxListResponse
  - `next_page_token` string
  - `sandboxes` ThundertypesSandboxGetResponse[]
    - `created_at` string, required
    - `expires_at` string
    - `failure` string
    - `failure_code` string — FailureCode and Failure explain a failed sandbox. Without them a caller sees only "failed" and cannot tell a capacity refusal from a broken control plane, which are acted on very differently.
    - `id` string, required
    - `lifetime` ThundertypesSandboxLifetime, required
      - `enforce_ttl` boolean
      - `max_grace_seconds` integer
      - `max_ttl_seconds` integer
    - `logs` ThundertypesSandboxLog[]
      - `data` ThundertypesSandboxLogData
        - `message` string
        - `node_name` string
        - `phase` string
      - `event` 'created' | 'scheduled' | 'started' | 'ready' | 'finished' | 'failed' | 'info', required
      - `id` string, required
      - `sandbox_id` string, required
      - `timestamp` string, required
    - `name` string, required
    - `network_policy` ThundertypesSandboxNetworkPolicy, required
      - `cidr_allowlist` string[]
      - `domain_allowlist` string[]
      - `internet_access` 'closed' | 'open' | 'restricted', required
    - `spec` ThundertypesSandboxResourceSpec, required
      - `cpu_count` integer, required
      - `gpu_count` integer
      - `gpu_type` 'A6000' | 'A100' | 'H100' | 'A6000' | 'A100' | 'H100'
      - `memory_gib` integer, required
      - `storage_gib` integer, required
    - `ssh` ThundertypesSandboxSSHConnection
      - `host` string
      - `port` integer
      - `user` string
    - `status` 'created' | 'ready' | 'finished' | 'failed', required
    - `stopped_at` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden

## Changes

- **2026-08-29** `122382e24d26` — 2 info
  - added the new optional `query` request parameter `status`
  - added the optional property `sandboxes/items/stopped_at` to the response with the `200` status
- **2026-08-27** `2115493485e6` — 1 info
  - endpoint added

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

---

[API](https://skmtc.dev/thundercompute/apis/thunder-compute-api.md) · [All operations](https://skmtc.dev/thundercompute/apis/thunder-compute-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/thundercompute/thunder-compute-api/revisions/122382e24d26/schema)