> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/daytonaio/daytona/llms.txt
> Use this file to discover all available pages before exploring further.

# List Sandboxes

> Retrieve a list of all sandboxes in your organization

Retrieves a list of all sandboxes for the authenticated organization with optional filtering.

## Headers

<ParamField header="X-Daytona-Organization-ID" type="string">
  Use with JWT to specify the organization ID
</ParamField>

## Query Parameters

<ParamField query="verbose" type="boolean">
  Include verbose output with additional sandbox details

  **Default:** `false`
</ParamField>

<ParamField query="labels" type="string">
  JSON encoded labels to filter by

  **Example:** `{"label1": "value1", "label2": "value2"}`
</ParamField>

<ParamField query="includeErroredDeleted" type="boolean">
  Include errored and deleted sandboxes in the results

  **Default:** `false`
</ParamField>

## Response

Returns an array of sandbox objects.

<ResponseField name="id" type="string">
  The unique identifier of the sandbox
</ResponseField>

<ResponseField name="organizationId" type="string">
  The organization ID of the sandbox
</ResponseField>

<ResponseField name="name" type="string">
  The name of the sandbox
</ResponseField>

<ResponseField name="snapshot" type="string">
  The snapshot used for the sandbox
</ResponseField>

<ResponseField name="user" type="string">
  The user associated with the sandbox
</ResponseField>

<ResponseField name="env" type="object">
  Environment variables for the sandbox
</ResponseField>

<ResponseField name="labels" type="object">
  Labels for the sandbox
</ResponseField>

<ResponseField name="public" type="boolean">
  Whether the sandbox HTTP preview is public
</ResponseField>

<ResponseField name="networkBlockAll" type="boolean">
  Whether all network access is blocked
</ResponseField>

<ResponseField name="networkAllowList" type="string">
  Comma-separated list of allowed CIDR network addresses
</ResponseField>

<ResponseField name="target" type="string">
  The target environment for the sandbox
</ResponseField>

<ResponseField name="cpu" type="number">
  The CPU quota for the sandbox
</ResponseField>

<ResponseField name="gpu" type="number">
  The GPU quota for the sandbox
</ResponseField>

<ResponseField name="memory" type="number">
  The memory quota for the sandbox in GB
</ResponseField>

<ResponseField name="disk" type="number">
  The disk quota for the sandbox in GB
</ResponseField>

<ResponseField name="state" type="string">
  The current state of the sandbox
</ResponseField>

<ResponseField name="desiredState" type="string">
  The desired state of the sandbox
</ResponseField>

<ResponseField name="errorReason" type="string">
  The error reason if the sandbox is in an error state
</ResponseField>

<ResponseField name="recoverable" type="boolean">
  Whether the sandbox error is recoverable
</ResponseField>

<ResponseField name="backupState" type="string">
  The state of the backup

  **Options:** `None`, `Pending`, `InProgress`, `Completed`, `Error`
</ResponseField>

<ResponseField name="backupCreatedAt" type="string">
  The creation timestamp of the last backup
</ResponseField>

<ResponseField name="autoStopInterval" type="number">
  Auto-stop interval in minutes
</ResponseField>

<ResponseField name="autoArchiveInterval" type="number">
  Auto-archive interval in minutes
</ResponseField>

<ResponseField name="autoDeleteInterval" type="number">
  Auto-delete interval in minutes
</ResponseField>

<ResponseField name="volumes" type="array">
  Array of volumes attached to the sandbox
</ResponseField>

<ResponseField name="createdAt" type="string">
  The creation timestamp of the sandbox
</ResponseField>

<ResponseField name="updatedAt" type="string">
  The last update timestamp of the sandbox
</ResponseField>

<ResponseField name="daemonVersion" type="string">
  The version of the daemon running in the sandbox
</ResponseField>

<ResponseField name="runnerId" type="string">
  The runner ID of the sandbox
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.daytona.io/sandbox?verbose=true" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "X-Daytona-Organization-ID: your-org-id"
  ```

  ```bash cURL with Labels Filter theme={null}
  curl -X GET 'https://api.daytona.io/sandbox?labels=%7B%22project%22%3A%22my-app%22%7D' \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "X-Daytona-Organization-ID: your-org-id"
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  [
    {
      "id": "sandbox123",
      "organizationId": "org456",
      "name": "my-development-sandbox",
      "snapshot": "ubuntu-4vcpu-8ram-100gb",
      "user": "daytona",
      "env": {
        "NODE_ENV": "development"
      },
      "labels": {
        "project": "my-app",
        "environment": "dev"
      },
      "public": false,
      "networkBlockAll": false,
      "target": "us-east-1",
      "cpu": 4,
      "gpu": 0,
      "memory": 8,
      "disk": 100,
      "state": "started",
      "desiredState": "started",
      "autoStopInterval": 60,
      "createdAt": "2024-10-01T12:00:00Z",
      "updatedAt": "2024-10-01T12:00:00Z",
      "daemonVersion": "1.0.0",
      "runnerId": "runner789"
    },
    {
      "id": "sandbox456",
      "organizationId": "org456",
      "name": "production-sandbox",
      "snapshot": "ubuntu-8vcpu-16ram-200gb",
      "user": "daytona",
      "env": {
        "NODE_ENV": "production"
      },
      "labels": {
        "project": "my-app",
        "environment": "prod"
      },
      "public": true,
      "networkBlockAll": false,
      "target": "us-west-2",
      "cpu": 8,
      "gpu": 0,
      "memory": 16,
      "disk": 200,
      "state": "started",
      "desiredState": "started",
      "createdAt": "2024-09-15T08:30:00Z",
      "updatedAt": "2024-10-01T09:45:00Z",
      "daemonVersion": "1.0.0",
      "runnerId": "runner123"
    }
  ]
  ```
</ResponseExample>