---
title: "List Runner runs"
method: GET
path: "/api/v1/runs/{forge}/{owner}/{repo}"
tags: ["Runs"]
---

# List Runner runs

`GET /api/v1/runs/{forge}/{owner}/{repo}`

## Path parameters

- `forge` 'gh' | 'et', required
- `owner` string, required
- `repo` string, required

## Query parameters

- `limit` integer

## Response `200`

Runner runs

- object
  - `runs` object[], required
    - `id` string, required
    - `provider` string, nullable, required
    - `repo_id` string, nullable, required
    - `repo_full_name` string, required
    - `ref` string, nullable, required
    - `agent` string, nullable, required
    - `environment_id` string, nullable, required
    - `session_id` string, nullable, required
    - `snapshot_name` string, nullable, required
    - `snapshot_source` 'base' | 'warm', nullable, required
    - `status` 'creating' | 'ready' | 'prompting' | 'succeeded' | 'failed' | 'timeout' | 'canceled' | 'deleted', required
    - `error_message` string, nullable, required
    - `automation` string, nullable, required
    - `trail_id` string, nullable, required
    - `head_sha` string, nullable, required
    - `setup_id` string, nullable, required
    - `credential_source` 'platform' | 'repo', nullable, required
    - `runtime_kind` 'sandbox' | 'inline', required
    - `scope_type` 'repo' | 'no_repo', required
    - `scope_json` unknown, required
    - `output_config` object, nullable, required
      - `adapter` 'json' | 'last_json_line' | 'markdown' | 'score' | 'none', required
      - `resultType` string, nullable, required
      - `scoreField` string, nullable, required
      - `trailsReviewEnabled` boolean
    - `execution_config` object, nullable, required
      - `model` string, nullable, required
      - `thinking_effort` string, nullable, required
    - `created_at` string, required
    - `updated_at` string, required
    - `deleted_at` string, nullable, required
    - `trail` object, nullable, required
      - `id` string, required
      - `number` integer, required
      - `title` string, required
      - `status` string, nullable, required
      - `branch` string, nullable, required
      - `gh_pr_id` integer, nullable, required
    - `setup` object, nullable, required
      - `id` string, required
      - `runner_id` string, required
      - `name` string, nullable, required
      - `pinned` boolean, required
      - `created_at` string, required
      - `updated_at` string, required

## Other responses

- `404` — Repository not found

---

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