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

# List sandboxes

`GET /api/v1/sandboxes`

List active Daytona sandboxes with id, state, created_at, and volume info.

## Query parameters

- `page` integer — Page number for pagination (starting from 1).
- `limit` integer — Maximum number of sandboxes per page.

## Response `200`

Successful Response

- SandboxListResponse — Response for the sandbox list endpoint.
  - `items` SandboxListItem[] — Available sandboxes.
    - `id` string, required — Sandbox identifier.
    - `name` string, required — Sandbox name.
    - `state` string, required — Sandbox state (e.g. started, stopped, archived).
    - `created_at` string, nullable — ISO-8601 creation timestamp when available.
    - `volume_name` string, nullable — Name of the persistent volume attached to the sandbox.
    - `labels` object — Custom labels attached to the sandbox.
    - `cpu` integer, nullable — Allocated CPU cores.
    - `memory` integer, nullable — Allocated memory in GiB.
    - `disk` integer, nullable — Allocated disk in GiB.
  - `total` integer, required — Total number of sandboxes.
  - `page` integer — Current page number.
  - `total_pages` integer — Total number of pages.

## Other responses

- `401` — Authentication is required or the provided token is invalid.
- `422` — Validation Error
- `503` — Sandbox services are unavailable because server startup is incomplete.

## Changes

- **2026-05-23** `6178f925cdec` — 1 breaking, 3 info
  - the `detail` response's property type/format changed from `array`/`` to ``/`` for status `422`
  - added `subschema #1, subschema #2` to the `detail` response property `anyOf` list for the response status `422`
  - added the required property `code` to the response with the `422` status
  - added the required property `message` to the response with the `422` status
- **2026-04-23** `e76335b7736c` — 1 info
  - endpoint added
- **2026-03-19** `78507b29ed8f` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/qredence/apis/fleet-rlm/changes/api/v1/sandboxes/get.md)

---

[API](https://skmtc.dev/qredence/apis/fleet-rlm.md) · [All operations](https://skmtc.dev/qredence/apis/fleet-rlm/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/qredence/fleet-rlm/revisions/e25aaded81b9/schema)