Skip to main content
GET
/
sandbox
curl -X GET "https://api.daytona.io/sandbox?verbose=true" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Daytona-Organization-ID: your-org-id"

[
  {
    "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"
  }
]
Retrieves a list of all sandboxes for the authenticated organization with optional filtering.

​
Headers

​
X-Daytona-Organization-ID
string
Use with JWT to specify the organization ID

​
Query Parameters

​
verbose
boolean
Include verbose output with additional sandbox detailsDefault: false
​
labels
string
JSON encoded labels to filter byExample: {"label1": "value1", "label2": "value2"}
​
includeErroredDeleted
boolean
Include errored and deleted sandboxes in the resultsDefault: false

​
Response

Returns an array of sandbox objects.
​
id
string
The unique identifier of the sandbox
​
organizationId
string
The organization ID of the sandbox
​
name
string
The name of the sandbox
​
snapshot
string
The snapshot used for the sandbox
​
user
string
The user associated with the sandbox
​
env
object
Environment variables for the sandbox
​
labels
object
Labels for the sandbox
​
public
boolean
Whether the sandbox HTTP preview is public
​
networkBlockAll
boolean
Whether all network access is blocked
​
networkAllowList
string
Comma-separated list of allowed CIDR network addresses
​
target
string
The target environment for the sandbox
​
cpu
number
The CPU quota for the sandbox
​
gpu
number
The GPU quota for the sandbox
​
memory
number
The memory quota for the sandbox in GB
​
disk
number
The disk quota for the sandbox in GB
​
state
string
The current state of the sandbox
​
desiredState
string
The desired state of the sandbox
​
errorReason
string
The error reason if the sandbox is in an error state
​
recoverable
boolean
Whether the sandbox error is recoverable
​
backupState
string
The state of the backupOptions: None, Pending, InProgress, Completed, Error
​
backupCreatedAt
string
The creation timestamp of the last backup
​
autoStopInterval
number
Auto-stop interval in minutes
​
autoArchiveInterval
number
Auto-archive interval in minutes
​
autoDeleteInterval
number
Auto-delete interval in minutes
​
volumes
array
Array of volumes attached to the sandbox
​
createdAt
string
The creation timestamp of the sandbox
​
updatedAt
string
The last update timestamp of the sandbox
​
daemonVersion
string
The version of the daemon running in the sandbox
​
runnerId
string
The runner ID of the sandbox
curl -X GET "https://api.daytona.io/sandbox?verbose=true" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Daytona-Organization-ID: your-org-id"

[
  {
    "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"
  }
]

Build docs developers (and LLMs) love

Get started for freeTalk to us