---
title: List Run Events
description: Read the durable event log for a run: started, node progress, and completion markers.
source: https://www.edgaze.ai/docs/api/list-events
section: api
---
# List Run Events

> Read the durable event log for a run: started, node progress, and completion markers.

```apibar
list-events
```

## Overview

Returns the durable, ordered event log for a run: `run.started`, `node.completed`, `run.completed`, and related markers. Each event has a monotonic sequence number and ISO timestamp.

Use alongside GET /runs/{id} when you need step-level visibility: for example, showing progress in a dashboard or debugging which node failed.

```doccallout
{"variant":"info","text":"Fetch after POST /runs while polling status. Events are append-only for the life of the run. There is no limit query parameter: the full log is returned."}
```

## Authorization

```apiscopes
list-events
```

## Parameters

```apiparams
list-events
```

## Response

Example payloads are in the request/response panel above.

## Edge cases

```apiedges
list-events
```

---

## Endpoint reference
- **Method:** `GET`
- **Path:** `https://api.edgaze.ai/v1/runs/{run_id}/events`
- **Scopes:** `run:read`
## Parameters
| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `Authorization` | header | string | yes | Bearer token with run:read scope. |
| `run_id` | path | string | yes | UUID returned from POST /runs. |
## Example responses

### 200 Success
```json
{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "events": [
    {
      "type": "run.started",
      "sequence": 1,
      "ts": "2026-07-08T10:00:00.000Z",
      "nodeId": null
    },
    {
      "type": "node.completed",
      "sequence": 2,
      "ts": "2026-07-08T10:00:15.000Z",
      "nodeId": "llm_1"
    },
    {
      "type": "run.completed",
      "sequence": 3,
      "ts": "2026-07-08T10:00:42.000Z",
      "nodeId": null
    }
  ]
}
```

### 404 Not found
```json
{
  "error": {
    "code": "not_found",
    "message": "Run not found."
  }
}
```

## Edge cases

### Full event log

The endpoint returns the complete ordered event log for the run.

### Use with polling

Combine GET /runs/{id} for outputs with GET /runs/{id}/events for step-by-step progress.