---
title: "List Run Sets"
method: GET
path: "/run_sets"
---

# List Run Sets

`GET /run_sets`

## Request

- Base URL: `https://api.traversal.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.traversal.com/run_sets`
- Auth: none declared

List all run sets.

Args:
    limit: Maximum number of run sets to return.
    offset: Number of run sets to skip.
    completed_only: If True, only return completed run sets.

## Query parameters

- `limit` integer
- `offset` integer
- `completed_only` boolean

## Response `200`

Successful Response

- ListRunSetsResponse: Response for listing run sets.
  - `run_sets` RunSetDTO[], required
    - `id` string, required
    - `name` string, nullable
    - `description` string, nullable
    - `image_url` string, nullable
    - `runs_per_incident` integer, required
    - `target_incident_ids` string[]
    - `created_at` string, nullable
    - `created_by` string, nullable
    - `started_at` string, nullable
    - `completed_at` string, nullable
    - `session_count` integer
    - `incident_count` integer
  - `total` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/traversal/apis/traversal-api.md) - [All operations](https://skmtc.dev/traversal/apis/traversal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/traversal/apis/traversal-api/revisions/31e1a8b7cf89?raw)