---
title: "List runs"
method: GET
path: "/api/v0/agent/sessions/{session_id}/runs"
tags: ["Agent"]
---

# List runs

`GET /api/v0/agent/sessions/{session_id}/runs`

List all runs in a session.

## Path parameters

- `session_id` string, uuid, required

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- AgentRunListResponse — Response for listing agent runs.
  - `runs` AgentRunGetResponse[], required — The list of agent runs.
    - `id` string, uuid, required — The ID of the run.
    - `status` string, required — The status of the run. Options: 'running', 'completed', 'error', 'cancelled'.
    - `input_message` string, required — The user's input message.
    - `final_response` string, nullable, required — The agent's final response.
    - `total_iterations` integer, required — Total agent loop iterations.
    - `error_message` string, nullable, required — Error message if the run failed.
    - `created_at` string, date-time, required — When the run was created.
    - `completed_at` string, date-time, nullable, required — When the run completed.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/outerport/apis/outerport-api.md) · [All operations](https://skmtc.dev/outerport/apis/outerport-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/outerport/outerport-api/revisions/f565b46daaea/schema)