Get a sandbox

GET

sandboxes

{id}

curl --request GET \
  --url https://api.runpod.io/v2/sandboxes/SANDBOX_ID \
  --header "Authorization: Bearer $RUNPOD_API_KEY"

import os
import requests

response = requests.get(
    "https://api.runpod.io/v2/sandboxes/SANDBOX_ID",
    headers={"Authorization": f"Bearer {os.environ['RUNPOD_API_KEY']}"},
)
print(response.json())

{
  "id": "7h3sbx91kq",
  "name": "my-sandbox",
  "state": "RUNNING",
  "templateId": null,
  "imageName": "python:3.12-slim",
  "cpuFlavorId": "cpu3c",
  "compute": {
    "vcpuCount": 2,
    "memoryInGb": 4,
    "containerDiskInGb": 10,
    "costPerHr": 0.026
  },
  "idleTimeoutSeconds": 300,
  "maxLifetimeSeconds": 3600,
  "lastActivityAt": "2026-09-29T14:02:40Z",
  "idleExpiresAt": "2026-09-29T14:07:40Z",
  "expiresAt": "2026-09-29T15:02:05Z",
  "labels": {"project": "checkout"},
  "terminationReason": null,
  "terminatedAt": null,
  "createdAt": "2026-09-29T14:02:05Z",
  "updatedAt": "2026-09-29T14:02:40Z"
}

Returns a single sandbox by ID. Terminated sandboxes remain readable, with state, terminationReason, and terminatedAt set. RUNNING means the backing compute is allocated, not that the container has finished pulling and started. A sandbox can report RUNNING for a short while (typically 10 to 30 seconds) before it accepts commands.

Path parameters

string

required

The sandbox ID.

Response

string

required

Unique sandbox identifier.

string

required

Human-readable name. Not required to be unique.

enum<string>

required

Current lifecycle state: CREATING, RUNNING, TERMINATED, or FAILED.

string | null

Template the sandbox was created from, if any.

string | null

Container image the sandbox runs, if it was created from an image.

string | null

CPU flavor backing the sandbox.

object

The compute currently backing the sandbox. Absent while the sandbox is CREATING and after it’s TERMINATED.

Show properties

number

required

Number of vCPUs.

number

required

Memory in GB.

integer

required

Container disk size in GB.

number

required

Current cost per hour in USD. Billing is per second at this rate.

integer

required

Seconds of inactivity after which the sandbox is terminated, after any clamping to the account maximum.

integer

required

Maximum total lifetime in seconds, after any clamping to the account maximum.

string<date-time>

required

Time of the most recent recorded activity.

string<date-time>

required

Time after which the sandbox is terminated for inactivity if no further activity occurs.

string<date-time>

required

Time after which the sandbox is terminated for reaching its maximum lifetime.

object

User-supplied string key-value labels.

string | null

Why the sandbox was terminated. null while the sandbox is alive.

string<date-time> | null

When the sandbox was terminated. null while the sandbox is alive.

string<date-time>

required

When the sandbox was created.

string<date-time>

required

When the sandbox was last updated.

Errors

Status	Meaning
`401`	The API key is missing or invalid.
`403`	The API key doesn’t have access to sandboxes.
`404`	No sandbox with this ID exists on your account.
`429`	Too many requests. Retry after a delay.

curl --request GET \
  --url https://api.runpod.io/v2/sandboxes/SANDBOX_ID \
  --header "Authorization: Bearer $RUNPOD_API_KEY"

import os
import requests

response = requests.get(
    "https://api.runpod.io/v2/sandboxes/SANDBOX_ID",
    headers={"Authorization": f"Bearer {os.environ['RUNPOD_API_KEY']}"},
)
print(response.json())

{
  "id": "7h3sbx91kq",
  "name": "my-sandbox",
  "state": "RUNNING",
  "templateId": null,
  "imageName": "python:3.12-slim",
  "cpuFlavorId": "cpu3c",
  "compute": {
    "vcpuCount": 2,
    "memoryInGb": 4,
    "containerDiskInGb": 10,
    "costPerHr": 0.026
  },
  "idleTimeoutSeconds": 300,
  "maxLifetimeSeconds": 3600,
  "lastActivityAt": "2026-09-29T14:02:40Z",
  "idleExpiresAt": "2026-09-29T14:07:40Z",
  "expiresAt": "2026-09-29T15:02:05Z",
  "labels": {"project": "checkout"},
  "terminationReason": null,
  "terminatedAt": null,
  "createdAt": "2026-09-29T14:02:05Z",
  "updatedAt": "2026-09-29T14:02:40Z"
}

Last modified on September 29, 2026

curl --request GET \
  --url https://api.runpod.io/v2/sandboxes/SANDBOX_ID \
  --header "Authorization: Bearer $RUNPOD_API_KEY"

import os
import requests

response = requests.get(
    "https://api.runpod.io/v2/sandboxes/SANDBOX_ID",
    headers={"Authorization": f"Bearer {os.environ['RUNPOD_API_KEY']}"},
)
print(response.json())

{
  "id": "7h3sbx91kq",
  "name": "my-sandbox",
  "state": "RUNNING",
  "templateId": null,
  "imageName": "python:3.12-slim",
  "cpuFlavorId": "cpu3c",
  "compute": {
    "vcpuCount": 2,
    "memoryInGb": 4,
    "containerDiskInGb": 10,
    "costPerHr": 0.026
  },
  "idleTimeoutSeconds": 300,
  "maxLifetimeSeconds": 3600,
  "lastActivityAt": "2026-09-29T14:02:40Z",
  "idleExpiresAt": "2026-09-29T14:07:40Z",
  "expiresAt": "2026-09-29T15:02:05Z",
  "labels": {"project": "checkout"},
  "terminationReason": null,
  "terminatedAt": null,
  "createdAt": "2026-09-29T14:02:05Z",
  "updatedAt": "2026-09-29T14:02:40Z"
}

API v2

Organization

Account

Pods

Clusters

Sandboxes

Serverless

Templates

Network Volumes

Global Volumes

Registries

Catalog

Billing

Path parameters

Response

Errors

​Path parameters

​Response

​Errors

Path parameters

Response

Errors