List sandboxes for the authenticated organization

Paginated list of sandboxes

GET /api/v1/sandboxes

cURL

curl --request GET \
  --url 'https://api.sandbox.stateset.app/api/v1/sandboxes' \
  --header "Authorization: Bearer $STATESET_SANDBOX_API_KEY"

200

{
  "sandboxes": [
    {
      "sandbox_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "org_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "session_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "status": "creating",
      "allocated_vcpu": 1.5,
      "allocated_memory_gib": 1.5,
      "created_at": "2026-08-31T14:22:05Z",
      "expires_at": "2026-08-31T14:22:05Z",
      "max_expires_at": "2026-08-31T14:22:05Z",
      "max_lifetime_seconds": 250,
      "remaining_extend_seconds": 250,
      "lifetime_used_seconds": 250,
      "lifetime_used_percent": 7.5
    }
  ],
  "pagination": {
    "limit": 20,
    "offset": 1,
    "total": 102,
    "has_more": true
  }
}

Query parameters

limit · integer

Max results (1-100, default 20)

offset · integer

Results offset (default 0)

state · string

Comma-separated state filter (e.g. running,paused)

Response

object

sandboxes · object[] · required

Show sandboxes

sandbox_id · string (uuid) · required

org_id · string · required

session_id · string · required

status · string · required

allocated_vcpu · number

Allocated vCPU cores

allocated_memory_gib · number

Allocated memory in GiB

created_at · string (date-time) · required

expires_at · string (date-time) · required

max_expires_at · string (date-time) · required

max_lifetime_seconds · integer · required

remaining_extend_seconds · integer · required

lifetime_used_seconds · integer · required

lifetime_used_percent · number · required

pagination · object · required

Show pagination

limit · integer · required

offset · integer · required

total · integer · required

has_more · boolean · required

Status codes

Code	Meaning
200	Paginated list of sandboxes

cURL

curl --request GET \
  --url 'https://api.sandbox.stateset.app/api/v1/sandboxes' \
  --header "Authorization: Bearer $STATESET_SANDBOX_API_KEY"

200

{
  "sandboxes": [
    {
      "sandbox_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "org_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "session_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "status": "creating",
      "allocated_vcpu": 1.5,
      "allocated_memory_gib": 1.5,
      "created_at": "2026-08-31T14:22:05Z",
      "expires_at": "2026-08-31T14:22:05Z",
      "max_expires_at": "2026-08-31T14:22:05Z",
      "max_lifetime_seconds": 250,
      "remaining_extend_seconds": 250,
      "lifetime_used_seconds": 250,
      "lifetime_used_percent": 7.5
    }
  ],
  "pagination": {
    "limit": 20,
    "offset": 1,
    "total": 102,
    "has_more": true
  }
}