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

# List Run Messages

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

## Request

- Base URL: `https://api.duvo.ai`
- URL: `https://api.duvo.ai/v2/runs/{run_id}/messages`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/duvo/apis/duvo-public-api/docs/v2/runs/:run_id/messages/get.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/duvo/apis/duvo-public-api.md) - [All operations](https://skmtc.dev/duvo/apis/duvo-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/duvo/apis/duvo-public-api/revisions/dafcf3d868a9?raw)