---
title: "List Run Commits"
method: GET
path: "/api/v1/runs/{id}/commits"
tags: ["Run Outputs"]
---

# List Run Commits

`GET /api/v1/runs/{id}/commits`

Returns commits on the run branch since the run's base SHA, sourced directly from sandbox Git.

The list uses first-parent chronological history and is capped by `limit` (default and maximum: 100). Commit data is Git-authoritative; Fabro-generated commit messages are not required for correctness.

## Path parameters

- `id` string, required

## Query parameters

- `limit` integer

## Response `200`

Commits on the run branch since the run base.

- PaginatedRunCommitList — Git commits on a run branch since the run base.
  - `data` RunCommit[], required
    - `sha` string, required
    - `short_sha` string, required
    - `parents` RunCommitParent[], required
      - `sha` string, required
      - `short_sha` string, required
    - `author` RunCommitPerson, required — Git author or committer identity.
      - `name` string, required
      - `email` string, required
      - `date` string, date-time, nullable, required
    - `committer` RunCommitPerson, required — Git author or committer identity.
      - `name` string, required
      - `email` string, required
      - `date` string, date-time, nullable, required
    - `subject` string, required
    - `body` string, nullable
    - `message` string, required
    - `trailers` object, required
    - `tree_sha` string, nullable, required
  - `meta` RunCommitsMeta, required — Metadata for a `PaginatedRunCommitList` response.
    - `source` 'sandbox', required
    - `base_sha` string, required
    - `head_sha` string, required
    - `limit` integer, required
    - `total_returned` integer, required
    - `truncated` boolean, required

## Other responses

- `400` — Malformed run id or query parameter.
- `404` — Run not found.
- `409` — Run has no active sandbox or no base SHA.
- `503` — Sandbox Git history is temporarily unavailable.

---

[API](https://skmtc.net/fabro-sh/apis/fabro-run-api.md) · [All operations](https://skmtc.net/fabro-sh/apis/fabro-run-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fabro-sh/fabro-run-api/revisions/52f1d8aaf083/schema)