Get sandbox status (lightweight)

Sandbox status

GET /api/v1/sandbox/{id}/status

cURL

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

200

{
  "sandbox_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "creating",
  "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
}

Path parameters

id · string (uuid) · required

Sandbox identifier

Response

object

sandbox_id · string (uuid) · required

status · string · 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

Status codes

Code	Meaning
200	Sandbox status

cURL

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

200

{
  "sandbox_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "creating",
  "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
}