---
title: "List runtimes"
method: GET
path: "/v1/runtimes"
tags: ["Runtimes"]
---

# List runtimes

`GET /v1/runtimes`

## Request

- Base URL: `https://api.1claw.co`
- URL: `https://api.1claw.co/v1/runtimes`
- Auth: HTTP bearer

## Response `200`

Runtime list

- RuntimeListResponse
  - `runtimes` RuntimeResponse[], required
    - `previous_image_digest` string, nullable
    - `image_digest` string, nullable: Resolved image (digest form when the provider reports one); runtime-minted agent tokens carry it as `runtime_image`, which access policies can require via `conditions.runtime_image_in`.
    - `schedule` object, nullable
    - `next_scheduled_start_at` string, date-time, nullable
    - `scheduled_stop_at` string, date-time, nullable
    - `id` string, uuid, required
    - `name` string, required
    - `agent_id` string, uuid, required
    - `template` string, nullable
    - `preset` string, nullable
    - `provider` string, nullable
    - `status` 'creating' | 'running' | 'stopping' | 'stopped' | 'failed' | 'deleting', required
    - `image` string, nullable
    - `environment` string, nullable: Vault environment for env var resolution
    - `env_public` object, nullable
    - `idle_timeout_secs` integer, nullable
    - `expose_http` boolean, nullable
    - `slug` string, nullable
    - `public_url` string, nullable
    - `http_port` integer, nullable
    - `inbound_auth` 'api_key' | 'jwt' | 'public', nullable
    - `shell_access_enabled` boolean
    - `shell_auth_policy` string
    - `shell_max_session_minutes` integer
    - `monthly_hours_used` number, nullable
    - `has_paid_addon` boolean: Whether this runtime has a paid Stripe add-on (unlimited hours).
    - `billing_kind` 'pool' | 'included' | 'addon': `pool` — counts against the plan's monthly runtime hours. `included` — the plan's free runtime (every plan from Pro up includes one small or medium runtime, no hour cap, no charge). `addon` — paid Stripe subscription item (no hour cap).
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `included_runtime` object: The plan's included-runtime allowance (human callers only).
    - `allowance` integer: Runtimes the plan includes at no charge.
    - `used` integer: Included slots currently in use.
    - `presets` string[]: Presets an included runtime may use (up to 1 vCPU / 2 GB).

## Other responses

- `401`: Authentication required or invalid

---

[API](https://skmtc.dev/1claw/apis/1claw-api.md) · [All operations](https://skmtc.dev/1claw/apis/1claw-api/llms.txt) · [OpenAPI document](https://skmtc.dev/1claw/apis/1claw-api/revisions/5fa0918f3b41?raw)