---
title: "List runs"
method: GET
path: "/agent/v1/run"
tags: ["Agents"]
---

# List runs

`GET /agent/v1/run`

Lists agent runs for the authenticated organization. Supports filtering by agent, status, and cursor-based pagination.

## Query parameters

- `agentId` string
- `status` 'queued' | 'running' | 'completed' | 'failed' | 'cancelled'
- `limit` integer
- `cursor` string

## Response `200`

List of runs

- object
  - `runs` object[]
    - `id` string
    - `agentId` string
    - `status` 'queued' | 'running' | 'completed' | 'failed' | 'cancelled'
    - `prompt` string — Truncated to first 200 characters
    - `model` string, nullable
    - `createdAt` string, date-time
    - `startedAt` string, date-time, nullable
    - `completedAt` string, date-time, nullable
  - `hasMore` boolean
  - `nextCursor` string, nullable — Pass as cursor to fetch the next page

## Other responses

- `400` — Invalid query parameters
- `401` — Invalid API key
- `403` — No agent access

---

[API](https://skmtc.net/casemark/apis/case-dev-api.md) · [All operations](https://skmtc.net/casemark/apis/case-dev-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/casemark/case-dev-api/versions/5b7e64e6d6f9/schema)