---
title: "list runs"
method: GET
path: "/repositories/{repository}/actions/runs"
tags: ["actions"]
---

# list runs

`GET /repositories/{repository}/actions/runs`

## Request

- Base URL: `/api/v1` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/v1/repositories/{repository}/actions/runs`
- Auth: one of:
  - HTTP bearer
  - HTTP basic
  - API key in cookie `internal_auth_session`

## Path parameters

- `repository` string, required

## Query parameters

- `after` string
- `amount` integer
- `branch` string
- `commit` string

## Response `200`

list action runs

- ActionRunList
  - `pagination` Pagination, required
    - `has_more` boolean, required: Next page is available
    - `next_offset` string, required: Token used to retrieve the next page
    - `results` integer, required: Number of values found in the results
    - `max_per_page` integer, required: Maximal number of entries per page
  - `results` ActionRun[], required
    - `run_id` string, required
    - `branch` string, required
    - `start_time` string, date-time, required
    - `end_time` string, date-time
    - `event_type` string, required
    - `status` 'failed' | 'completed', required
    - `commit_id` string, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Resource Not Found
- `429`: too many requests
- `default`: Internal Server Error

## Changes

- **2025-11-24** `add5a8870f32`: 1 info
  - added the non-success response with the status `400`
- **2025-07-29** `27799ffec9a5`: 2 info
  - added the non-success response with the status `429`
  - removed the non-success response with the status `420`
- **2024-09-17** `3b10653a8013`: 3 info
  - added the non-success response with the status `420`
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `429`

[Operation history](https://skmtc.dev/treeverse/apis/lakefs-api/changes/repositories/:repository/actions/runs/get.md)

---

[API](https://skmtc.dev/treeverse/apis/lakefs-api.md) - [All operations](https://skmtc.dev/treeverse/apis/lakefs-api/llms.txt) - [OpenAPI document](https://skmtc.dev/treeverse/apis/lakefs-api/revisions/10a3acbbb1fd?raw)