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

# checks_list_for_ref

> List the check runs reported against a commit, branch or tag — every CI provider that reports as a GitHub App, Actions included. `ref` takes a SHA, 'heads/BRANCH' or 'tags/TAG'. The `status` filter takes a status only: a failure is `status: completed` plus a `conclusion` of 'failure'.

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

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

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

<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.                     |
  | `ref` <span className="required" title="required">\*</span>   | `string` | The commit reference. Can be a commit SHA, branch name (`heads/BRANCH_NAME`), or tag name (`tags/TAG_NAME`). |
</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>                                                 |
  | `checkName` | `string`                                                                          | Returns check runs with the specified `name`.                                                                                                                           |
  | `status`    | [CheckRunStatusFilter](/charter/charter/packs/github/checks/objects#checkrunstatusfilter) | Returns check runs with the specified `status`. This filter takes a status only — a failed run is `status: completed` with a `conclusion` of `failure` on the way back. |
  | `filter`    | [JobFilter](/charter/charter/packs/github/actions/objects#jobfilter)                      | Filters check runs by their `completed_at` timestamp. `latest` returns the most recent check runs. GitHub uses `latest` when this is absent.                            |
  | `appId`     | `integer`                                                                         | Only check runs reported by this GitHub App. GitHub Actions is itself an App, so this is how a repository with several CI providers is narrowed to one.                 |
</div>