Skip to main content
GET
/
v1
/
sandboxes
curl "https://api.runtools.ai/v1/sandboxes?status=running&limit=10" \
  -H "X-API-Key: rt_live_xxx"

{
  "data": [
    {
      "id": "sandbox-abc123",
      "status": "running",
      "template": "nodejs-20",
      "createdAt": "2025-01-21T10:00:00Z"
    },
    {
      "id": "sandbox-def456",
      "status": "running",
      "template": "python-ml",
      "createdAt": "2025-01-21T09:00:00Z"
    }
  ],
  "meta": {
    "hasMore": true,
    "nextCursor": "eyJpZCI6InNhbmRib3gtZGVmNDU2In0="
  }
}

​
Query Parameters

​
status
string
Filter by status: creating, running, paused, stopped
​
limit
number
default:"50"
Max results to return (1-100)
​
cursor
string
Pagination cursor from previous response

​
Response

​
data
array
Array of sandbox objects
​
meta.hasMore
boolean
Whether more results exist
​
meta.nextCursor
string
Cursor for next page
curl "https://api.runtools.ai/v1/sandboxes?status=running&limit=10" \
  -H "X-API-Key: rt_live_xxx"

{
  "data": [
    {
      "id": "sandbox-abc123",
      "status": "running",
      "template": "nodejs-20",
      "createdAt": "2025-01-21T10:00:00Z"
    },
    {
      "id": "sandbox-def456",
      "status": "running",
      "template": "python-ml",
      "createdAt": "2025-01-21T09:00:00Z"
    }
  ],
  "meta": {
    "hasMore": true,
    "nextCursor": "eyJpZCI6InNhbmRib3gtZGVmNDU2In0="
  }
}