> ## 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_runs_for_workflow

> List the runs of one workflow, most recent first — 'is this pipeline green', rather than 'is anything red'. The same single `status` filter as `actions_list_workflow_runs`, which matches a status or a conclusion.

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

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

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

<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.                                           |
  | `workflowId` <span className="required" title="required">\*</span> | `integer` \| `string` | The ID of the workflow. You can also pass the workflow file name as a string, such as `ci.yml`, which is usually the one you have. |
</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>                                                                                                                        |
  | `actor`               | `string`                                                                                 | Returns someone's workflow runs. Use the login for the user who created the `push` associated with the check suite or workflow run.                                                                                                            |
  | `branch`              | `string`                                                                                 | Returns workflow runs associated with a branch. Use the name of the branch of the `push`.                                                                                                                                                      |
  | `event`               | `string`                                                                                 | Returns workflow run triggered by the event you specify. For example, `push`, `pull_request` or `issue`.                                                                                                                                       |
  | `status`              | [WorkflowRunStatusFilter](/charter/charter/packs/github/actions/objects#workflowrunstatusfilter) | Returns workflow runs with the check run `status` or `conclusion` that you specify. For example, a conclusion can be `success` or a status can be `in_progress`. Only GitHub Actions can set a status of `waiting`, `pending`, or `requested`. |
  | `created`             | `string`                                                                                 | Returns workflow runs created within the given date-time range, in GitHub's search syntax: '>=2026-01-01' or '2026-01-01..2026-02-01'.                                                                                                         |
  | `excludePullRequests` | `boolean`                                                                                | If `true` pull requests are omitted from the response (empty array).                                                                                                                                                                           |
  | `checkSuiteId`        | `integer`                                                                                | Returns workflow runs with the `check_suite_id` that you specify.                                                                                                                                                                              |
  | `headSha`             | `string`                                                                                 | Only returns workflow runs that are associated with the specified `head_sha`.                                                                                                                                                                  |
</div>