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

# Retrieve run events

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

## Request

- Base URL: `https://api.trigger.dev`
- URL: `https://api.trigger.dev/api/v1/runs/{runId}/events`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/docs/api/v1/runs/:runId/events/get.ts> (a function with typed inputs; its response is checked against the schema)

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

## Changes

- **2026-02-24** `6ec7a0ed3a5e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/changes/api/v1/runs/:runId/events/get.md)

---

[API](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api.md) - [All operations](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/revisions/441161111493?raw)