---
title: "List Run Messages"
method: GET
path: "/v2/runs/{run_id}/messages"
tags: ["Runs"]
---

# List Run Messages

`GET /v2/runs/{run_id}/messages`

Get paginated messages for an agent run. Messages are returned in chronological order.

## Path parameters

- `run_id` string, uuid, required

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Default Response

- object
  - `messages` object[], required — Messages for the run, in chronological order
    - `id` string, required — Unique message identifier
    - `type` string, required — Message type
    - `role` string, required — Sender role (e.g., user, assistant, tool)
    - `timestamp` string, required — ISO 8601 timestamp when the message was sent
    - `text_content` string — Plain text content of the message
    - `tool_call` object — Tool invocation details when role is assistant
      - `id` string, required — Tool call identifier
      - `name` string, required — Tool name being invoked
      - `arguments` object — Arguments passed to the tool
    - `tool_result` object — Tool result details when role is tool
      - `tool_call_id` string, required — ID of the tool call this result corresponds to
      - `result` unknown
      - `error` string — Error message if the tool invocation failed
  - `total` number, required — Total number of messages for the run
  - `limit` number, required — Number of messages per page
  - `offset` number, required — Number of messages skipped

## Other responses

- `400` — Default Response
- `401` — Default Response
- `403` — Default Response
- `404` — Default Response
- `500` — Default Response

---

[API](https://skmtc.net/duvo/apis/duvo-public-api.md) · [All operations](https://skmtc.net/duvo/apis/duvo-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/duvo/duvo-public-api/revisions/dafcf3d868a9/schema)