---
title: "List events"
method: GET
path: "/ai/missions/{mission_id}/runs/{run_id}/events"
tags: ["Missions"]
---

# List events

`GET /ai/missions/{mission_id}/runs/{run_id}/events`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/ai/missions/{mission_id}/runs/{run_id}/events`
- Auth: HTTP bearer

Returns a paginated list of events logged for the specified run, filterable by event type, plan step, and agent, so you can reconstruct exactly what happened during execution.

## Path parameters

- `mission_id` string, uuid, required
- `run_id` string, uuid, required

## Query parameters

- `type` string
- `step_id` string
- `agent_id` string
- `page[number]` integer: Page number (1-based)
- `page[size]` integer: Number of items per page

## Response `200`

Successful Response

- EventsListResponse
  - `data` EventData[], required
    - `event_id` string, required
    - `run_id` string, required
    - `type` 'status_change' | 'step_started' | 'step_completed' | 'step_failed' | 'tool_call' | 'tool_result' | 'message' | 'error' | 'custom', required
    - `summary` string, required
    - `timestamp` string, date-time, required
    - `step_id` string
    - `agent_id` string
    - `payload` object
    - `idempotency_key` string
  - `meta` Meta, required
    - `total_pages` integer, required
    - `total_results` integer, required
    - `page_number` integer, required
    - `page_size` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api-2.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/revisions/f82938f53ff4?raw)