> ## Documentation Index
> Fetch the complete documentation index at: https://docs.r28.ai/charter/llms.txt
> Use this file to discover all available pages before exploring further.

# actions_list_workflow_runs

> List CI runs, most recent first. The single `status` filter matches either a run's status or its conclusion, so 'in_progress' and 'failure' are both valid there.

<div className="tool-route"><span className="tool-row-method" data-method="GET">GET</span><code>{"https://api.github.com/repos/{owner}/{repo}/actions/runs"}</code></div>

```python github_actions_list_workflow_runs.py theme={null}
from charter.packs import github

result = await github.actions_list_workflow_runs.ainvoke({"owner": ..., "repo": ...})
```

<Note>
  Requires `repo`, `read:user`. Pages by number: `page` with `per_page`.
</Note>

## Path parameters

<div className="reference-table">
  | Field                                                         | Type     | Description                                                                              |
  | ------------------------------------------------------------- | -------- | ---------------------------------------------------------------------------------------- |
  | `owner` <span className="required" title="required">\*</span> | `string` | The account owner of the repository. The name is not case sensitive.                     |
  | `repo` <span className="required" title="required">\*</span>  | `string` | The name of the repository without the `.git` extension. The name is not case sensitive. |
</div>

## Query parameters

<div className="reference-table">
  | Field                 | Type                                                                                     | Description                                                                                                                             |
  | --------------------- | ---------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
  | `perPage`             | `integer`                                                                                | The number of results per page (max 100). Defaults to 30. <span className="field-constraints">≥ 1; ≤ 100; defaults to `30`</span>       |
  | `page`                | `integer`                                                                                | The page number of the results to fetch. Defaults to 1. <span className="field-constraints">≥ 1; defaults to `1`</span>                 |
  | `status`              | [WorkflowRunStatusFilter](/charter/charter/packs/github/actions/objects#workflowrunstatusfilter) | Match a run's status or its conclusion. 'in\_progress' and 'queued' are statuses; 'success', 'failure' and 'cancelled' are conclusions. |
  | `branch`              | `string`                                                                                 | Only runs for pushes to this branch.                                                                                                    |
  | `event`               | `string`                                                                                 | Only runs triggered by this event, such as 'push' or 'pull\_request'.                                                                   |
  | `actor`               | `string`                                                                                 | Only runs for pushes by this username.                                                                                                  |
  | `headSha`             | `string`                                                                                 | Only runs for this commit SHA.                                                                                                          |
  | `created`             | `string`                                                                                 | Only runs created in this window, in GitHub's search syntax: '>=2026-01-01' or '2026-01-01..2026-02-01'.                                |
  | `excludePullRequests` | `boolean`                                                                                | Leave the pull requests off each run. They are the bulkiest part of the response and rarely the reason for listing runs.                |
</div>