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

# Get a sandbox

`GET /sandboxes/{id}`

## Request

- Base URL: `https://api.eqvps.com/api/v1/eqvps`
- URL: `https://api.eqvps.com/api/v1/eqvps/sandboxes/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Response `200`

Sandbox

- Sandbox
  - `id` string
  - `mode` 'ephemeral' | 'persistent'
  - `tariff` string
  - `state` 'running' | 'starting' | 'paused' | 'pausing' | 'resuming' | 'deleting': running = ready for commands (the internal sbxd state 'busy' is shown as running)
  - `created_at` string, date-time
  - `expires_at` string, date-time
  - `last_active` string, date-time
  - `idle_timeout` integer
  - `ttl` integer
  - `throttled` boolean
  - `paused_at` string, date-time
  - `pause_reason` string
  - `delete_after` string, date-time
  - `price_usd_per_hour` number
  - `ready` boolean: true when commands can run
  - `env_keys` string[]: Names of environment variables set on create (values are never returned)

## Other responses

- `404`: not_found
- `410`: sandbox_deleted (paused snapshot expired)

---

[API](https://skmtc.dev/eqvps/apis/eqvps-api.md) · [All operations](https://skmtc.dev/eqvps/apis/eqvps-api/llms.txt) · [OpenAPI document](https://skmtc.dev/eqvps/apis/eqvps-api/revisions/2cbc15a2b088?raw)