---
title: "Retrieve run events"
method: GET
path: "/api/v1/runs/{runId}/events"
tags: ["runs"]
---

# Retrieve run events

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

Returns all OTel span events for a run. Useful for debugging and observability.

## Response `200`

Successful request

- object
  - `events` object[]
    - `spanId` string — The span ID of the event.
    - `parentId` string, nullable — The parent span ID, if any.
    - `runId` string, nullable — The run ID associated with this event.
    - `message` string — The event message.
    - `startTime` string — The start time of the event as a bigint string (nanoseconds since epoch).
    - `duration` number — The duration of the event in nanoseconds.
    - `isError` boolean — Whether this event represents an error.
    - `isPartial` boolean — Whether this event is partial (still in progress).
    - `isCancelled` boolean — Whether this event was cancelled.
    - `level` 'TRACE' | 'DEBUG' | 'LOG' | 'INFO' | 'WARN' | 'ERROR' — The log level of the event.
    - `kind` 'UNSPECIFIED' | 'INTERNAL' | 'SERVER' | 'CLIENT' | 'PRODUCER' | 'CONSUMER' | 'UNRECOGNIZED' | 'LOG' — The kind of span event.
    - `attemptNumber` number, nullable — The attempt number this event belongs to.
    - `taskSlug` string — The task identifier.
    - `events` object[] — Span events (e.g. exceptions, cancellations) that occurred during this event.
      - `name` string — The event name (e.g. "exception", "cancellation", "attempt_failed").
      - `time` string, date-time — The time the event occurred.
      - `properties` object — Event-specific properties.
    - `style` object — Display style metadata for the event.
      - `icon` string — Icon identifier for display.
      - `variant` string — Visual variant (e.g. "success", "failure").
      - `accessory` object — Accessory display element.
        - `text` string
        - `style` 'codepath'

## Other responses

- `401` — Unauthorized request
- `404` — Resource not found

---

[API](https://skmtc.net/winsenlabs/apis/trigger-dev-v3-rest-api.md) · [All operations](https://skmtc.net/winsenlabs/apis/trigger-dev-v3-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/winsenlabs/trigger-dev-v3-rest-api/revisions/5a645d85c8c4/schema)