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

# List sandboxes

`GET /sandboxes`

## Request

- Base URL: `https://sandbox-as-a-service.com/v1`
- URL: `https://sandbox-as-a-service.com/v1/sandboxes`
- Auth: HTTP bearer

## Query parameters

- `limit` integer
- `starting_after` string, date-time
- `include_deleted` boolean

## Response `200`

A page of sandboxes, newest first.

- object
  - `object` 'list'
  - `data` Sandbox[]
    - `object` 'sandbox'
    - `id` string
    - `name` string, nullable
    - `status` 'provisioning' | 'running' | 'deleting' | 'deleted' | 'failed': Lifecycle state. Commands can only run while the sandbox is `running`.
    - `size` 'small' | 'medium' | 'large'
    - `resources` object
      - `vcpu` integer
      - `memory_gb` integer
      - `disk_gb` integer
    - `timeout_minutes` integer
    - `created_at` string, date-time
    - `ready_at` string, date-time, nullable
    - `expires_at` string, date-time, nullable
    - `deleted_at` string, date-time, nullable
  - `has_more` boolean
  - `next_cursor` string, nullable

## Other responses

- `401`: Missing or invalid API key.

---

[API](https://skmtc.dev/sandbox-as-a-service/apis/sandbox-as-a-service-api.md) · [All operations](https://skmtc.dev/sandbox-as-a-service/apis/sandbox-as-a-service-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sandbox-as-a-service/apis/sandbox-as-a-service-api/revisions/4f1ea2cf8333?raw)