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

# List runtimes

`GET /v1/runtimes`

Returns a list of runtimes in your project.

## Query parameters

- `starting_after` string
- `limit` integer

## Response `200`

OK

- ListRuntimesResponse
  - `runtimes` Runtime[], required
    - `additional_python_imports` string
    - `engine` 'wasi' | 'microvm' | 'v8', required
    - `id` string, required
    - `language` 'python' | 'javascript', required
    - `manifest_file` ManifestFile
      - `contents` string, required
      - `name` 'requirements.txt' | 'package.json', required
    - `name` string, required
    - `revision_id` string, required
    - `status` 'pending' | 'building' | 'succeeded' | 'failed' | 'cancelled', required

## Other responses

- `401` — Unauthenticated error response

## Changes

- **2025-04-24** `f9777846c474` — 3 info
  - added the new optional `query` request parameter `limit`
  - added the new optional `query` request parameter `starting_after`
  - added the required property `runtimes/items/engine` to the response with the `200` status
- **2025-03-19** `45af77c4f3bd` — 5 warning
  - added the new `building` enum value to the `runtimes/items/status` response property for the response status `200`
  - added the new `cancelled` enum value to the `runtimes/items/status` response property for the response status `200`
  - added the new `failed` enum value to the `runtimes/items/status` response property for the response status `200`
  - added the new `pending` enum value to the `runtimes/items/status` response property for the response status `200`
  - …1 more
- **2025-02-05** `4ca61d8b4e33` — 1 breaking
  - the `code` response's property type/format changed from `integer`/`int32` to `integer`/`` for status `401`
- …earlier changes not shown

[Full history](https://skmtc.dev/riza-io/apis/execute/changes/v1/runtimes/get.md)

---

[API](https://skmtc.dev/riza-io/apis/execute.md) · [All operations](https://skmtc.dev/riza-io/apis/execute/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/riza-io/execute/revisions/bab65e0b0c2b/schema)