---
title: "List run events"
method: GET
path: "/api/v1/runs/{run_id}/events"
tags: ["Runs"]
---

# List run events

`GET /api/v1/runs/{run_id}/events`

## Request

- Base URL: `https://api.studio.kaitoi.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.studio.kaitoi.io/api/v1/runs/{run_id}/events`
- Auth: HTTP bearer

Returns persisted lifecycle, progress, and log events for a REST API run. Cursors are opaque and are only valid for the same run and API key owner that issued them.

## Path parameters

- `run_id` string, required

## Query parameters

- `limit` integer, nullable: Maximum number of events to return. Defaults to 50; capped at 200.
- `cursor` string, nullable: Opaque cursor returned from the previous page.

## Headers

- `authorization` string, nullable

## Response `200`

A page of run events.

- PublicListResponsePublicRunEvent
  - `data` PublicRunEvent[], required: Items returned for this page.
    - `id` string, required
    - `runId` string, required
    - `type` string, required: Stable event type, such as run.accepted, node.progress, or node.log.
    - `message` string, nullable
    - `nodeId` string, nullable
    - `progress` number, nullable
    - `data` object
    - `createdAt` string, date-time, required
  - `nextCursor` string, nullable: Opaque cursor for the next page. Omitted when there are no more results.
  - `hasMore` boolean, required: True when another page is available.

## Other responses

- `400`: The cursor or limit is invalid.
- `401`: Missing, malformed, expired, or revoked bearer token.
- `403`: The API key lacks the required scope or account capability.
- `404`: The run does not exist or is not owned by this user.
- `422`: Validation Error
- `429`: The client or API key exceeded the REST API rate limit.
- `503`: The shared REST API rate limiter is temporarily unavailable.

---

[API](https://skmtc.dev/kaitoi/apis/kaitoi-rest-api.md) · [All operations](https://skmtc.dev/kaitoi/apis/kaitoi-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kaitoi/apis/kaitoi-rest-api/revisions/239a74aa2c64?raw)