---
title: "Get a sandbox"
method: GET
path: "/sandboxes/{id}"
tags: ["Sandboxes"]
---

# Get a sandbox

`GET /sandboxes/{id}`

## Request

- Base URL: `https://sandbox-as-a-service.com/v1`
- URL: `https://sandbox-as-a-service.com/v1/sandboxes/{id}`
- Auth: HTTP bearer

## Response `200`

The sandbox.

- Sandbox
  - `object` 'sandbox'
  - `id` string
  - `name` string, nullable
  - `status` 'provisioning' | 'running' | 'deleting' | 'deleted' | 'failed': Lifecycle state. Commands can only run while the sandbox is `running`.
  - `size` 'small' | 'medium' | 'large'
  - `resources` object
    - `vcpu` integer
    - `memory_gb` integer
    - `disk_gb` integer
  - `timeout_minutes` integer
  - `created_at` string, date-time
  - `ready_at` string, date-time, nullable
  - `expires_at` string, date-time, nullable
  - `deleted_at` string, date-time, nullable

## Other responses

- `401`: Missing or invalid API key.
- `404`: No sandbox with that id for this account.

---

[API](https://skmtc.dev/sandbox-as-a-service/apis/sandbox-as-a-service-api.md) · [All operations](https://skmtc.dev/sandbox-as-a-service/apis/sandbox-as-a-service-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sandbox-as-a-service/apis/sandbox-as-a-service-api/revisions/4f1ea2cf8333?raw)