curl --silent --show-error --fail-with-body --request GET \
--url 'https://api.sandbox.stateset.app/api/v1/sandbox/{id}' \
--header "Authorization: ApiKey $STATESET_SANDBOX_API_KEY"
{
"sandbox_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"org_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"session_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"status": "creating",
"pod_ip": "string",
"sandbox_epoch": 1,
"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,
"startup_metrics": {
"total_ms": 250,
"pod_creation_ms": 250,
"pod_ready_ms": 250,
"phases": [
{
"name": "Two-Person Tent",
"durationMs": 7.5
}
]
}
}
Get sandbox details
Sandbox details
GET
/
api
/
v1
/
sandbox
/
{id}
curl --silent --show-error --fail-with-body --request GET \
--url 'https://api.sandbox.stateset.app/api/v1/sandbox/{id}' \
--header "Authorization: ApiKey $STATESET_SANDBOX_API_KEY"
{
"sandbox_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"org_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"session_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"status": "creating",
"pod_ip": "string",
"sandbox_epoch": 1,
"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,
"startup_metrics": {
"total_ms": 250,
"pod_creation_ms": 250,
"pod_ready_ms": 250,
"phases": [
{
"name": "Two-Person Tent",
"durationMs": 7.5
}
]
}
}
Confirm your deployment before running this request. This page describes an API contract;
a published reference does not establish hosted availability. Check the dated
host report and obtain your deployment URL and credentials.
Replace the example host if your provisioned service uses a different URL.
Path parameters
string (uuid)
required
Sandbox identifier
Response
SandboxResponse
string (uuid)
required
Unique sandbox identifier.
string
required
Organization that owns this sandbox.
string
required
Session identifier.
string
required
Current sandbox status. Allowed values:
'creating', 'running', 'paused', 'terminating', 'terminated', 'error'.string
Internal pod IP address.
integer
required
Sandbox recycle epoch counter. Minimum:
-9007199254740991. Maximum: 9007199254740991.number
Allocated vCPU cores.
number
Allocated memory in GiB.
string (date-time)
required
ISO 8601 creation timestamp.
string (date-time)
required
ISO 8601 expiration timestamp.
string (date-time)
required
Maximum possible expiration.
integer
required
Maximum sandbox lifetime in seconds. Minimum:
-9007199254740991. Maximum: 9007199254740991.integer
required
Seconds available for extension. Minimum:
-9007199254740991. Maximum: 9007199254740991.integer
required
Seconds of lifetime consumed. Minimum:
-9007199254740991. Maximum: 9007199254740991.number
required
Percentage of lifetime consumed.
object
Status codes
| Code | Meaning |
|---|---|
200 | Sandbox details |
404 | Sandbox not found |
Using this contract
Read the source OpenAPI document for declared schemas and alternatives. This page also includes documented corrections from the spec overlays. Example IDs and values are illustrative; replace them with records from your workspace.curl --silent --show-error --fail-with-body --request GET \
--url 'https://api.sandbox.stateset.app/api/v1/sandbox/{id}' \
--header "Authorization: ApiKey $STATESET_SANDBOX_API_KEY"
{
"sandbox_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"org_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"session_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"status": "creating",
"pod_ip": "string",
"sandbox_epoch": 1,
"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,
"startup_metrics": {
"total_ms": 250,
"pod_creation_ms": 250,
"pod_ready_ms": 250,
"phases": [
{
"name": "Two-Person Tent",
"durationMs": 7.5
}
]
}
}
Last modified on September 21, 2026