---
title: "List workflow runs for a repository"
method: GET
path: "/repos/{owner}/{repo}/actions/runs"
tags: ["actions"]
---

# List workflow runs for a repository

`GET /repos/{owner}/{repo}/actions/runs`

Lists all workflow runs for a repository. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/rest/guides/getting-started-with-the-rest-api#parameters).

Anyone with read access to the repository can use this endpoint.

OAuth app tokens and personal access tokens (classic) need the `repo` scope to use this endpoint with a private repository.

This endpoint will return up to 1,000 results for each search when using the following parameters: `actor`, `branch`, `check_suite_id`, `created`, `event`, `head_sha`, `status`.

## Path parameters

- `owner` string, required
- `repo` string, required

## Query parameters

- `actor` string
- `branch` string
- `event` string
- `status` 'completed' | 'action_required' | 'cancelled' | 'failure' | 'neutral' | 'skipped' | 'stale' | 'success' | 'timed_out' | 'in_progress' | 'queued' | 'requested' | 'waiting' | 'pending'
- `per_page` integer
- `page` integer
- `created` string, date-time
- `exclude_pull_requests` boolean
- `check_suite_id` integer
- `head_sha` string

## Response `200`

Response

- object
  - `total_count` integer, required
  - `workflow_runs` WorkflowRun[], required
    - `id` integer, required — The ID of the workflow run.
    - `name` string, nullable — The name of the workflow run.
    - `node_id` string, required
    - `check_suite_id` integer — The ID of the associated check suite.
    - `check_suite_node_id` string — The node ID of the associated check suite.
    - `head_branch` string, nullable, required
    - `head_sha` string, required — The SHA of the head commit that points to the version of the workflow being run.
    - `path` string, required — The full path of the workflow
    - `run_number` integer, required — The auto incrementing run number for the workflow run.
    - `run_attempt` integer — Attempt number of the run, 1 for first attempt and higher if the workflow was re-run.
    - `referenced_workflows` ReferencedWorkflow[], nullable
      - `path` string, required
      - `sha` string, required
      - `ref` string
    - `event` string, required
    - `status` string, nullable, required
    - `conclusion` string, nullable, required
    - `workflow_id` integer, required — The ID of the parent workflow.
    - `url` string, required — The URL to the workflow run.
    - `html_url` string, required
    - `pull_requests` PullRequestMinimal[], nullable, required — Pull requests that are open with a `head_sha` or `head_branch` that matches the workflow run. The returned pull requests do not necessarily indicate pull requests that triggered the run.
      - `id` integer, required
      - `number` integer, required
      - `url` string, required
      - `head` object, required
        - `ref` string, required
        - `sha` string, required
        - `repo` object, required
          - `id` integer, required
          - `url` string, required
          - `name` string, required
      - `base` object, required
        - `ref` string, required
        - `sha` string, required
        - `repo` object, required
          - `id` integer, required
          - `url` string, required
          - `name` string, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `actor` SimpleUser — A GitHub user.
      - `name` string, nullable
      - `email` string, nullable
      - `login` string, required
      - `id` integer, required
      - `node_id` string, required
      - `avatar_url` string, uri, required
      - `gravatar_id` string, nullable, required
      - `url` string, uri, required
      - `html_url` string, uri, required
      - `followers_url` string, uri, required
      - `following_url` string, required
      - `gists_url` string, required
      - `starred_url` string, required
      - `subscriptions_url` string, uri, required
      - `organizations_url` string, uri, required
      - `repos_url` string, uri, required
      - `events_url` string, required
      - `received_events_url` string, uri, required
      - `type` string, required
      - `site_admin` boolean, required
      - `starred_at` string
      - `user_view_type` string
    - `triggering_actor` SimpleUser — A GitHub user.
      - `name` string, nullable
      - `email` string, nullable
      - `login` string, required
      - `id` integer, required
      - `node_id` string, required
      - `avatar_url` string, uri, required
      - `gravatar_id` string, nullable, required
      - `url` string, uri, required
      - `html_url` string, uri, required
      - `followers_url` string, uri, required
      - `following_url` string, required
      - `gists_url` string, required
      - `starred_url` string, required
      - `subscriptions_url` string, uri, required
      - `organizations_url` string, uri, required
      - `repos_url` string, uri, required
      - `events_url` string, required
      - `received_events_url` string, uri, required
      - `type` string, required
      - `site_admin` boolean, required
      - `starred_at` string
      - `user_view_type` string
    - `run_started_at` string, date-time — The start time of the latest run. Resets on re-run.
    - `jobs_url` string, required — The URL to the jobs for the workflow run.
    - `logs_url` string, required — The URL to download the logs for the workflow run.
    - `check_suite_url` string, required — The URL to the associated check suite.
    - `artifacts_url` string, required — The URL to the artifacts for the workflow run.
    - `cancel_url` string, required — The URL to cancel the workflow run.
    - `rerun_url` string, required — The URL to rerun the workflow run.
    - `previous_attempt_url` string, nullable — The URL to the previous attempted run of this workflow, if one exists.
    - `workflow_url` string, required — The URL to the workflow.
    - `head_commit` NullableSimpleCommit, nullable, required — A commit.
      - `id` string, required — SHA for the commit
      - `tree_id` string, required — SHA for the commit's tree
      - `message` string, required — Message describing the purpose of the commit
      - `timestamp` string, date-time, required — Timestamp of the commit
      - `author` object, nullable, required — Information about the Git author
        - `name` string, required — Name of the commit's author
        - `email` string, email, required — Git email address of the commit's author
      - `committer` object, nullable, required — Information about the Git committer
        - `name` string, required — Name of the commit's committer
        - `email` string, email, required — Git email address of the commit's committer
    - `repository` MinimalRepository, required — Minimal Repository
      - `id` integer, required
      - `node_id` string, required
      - `name` string, required
      - `full_name` string, required
      - `owner` SimpleUser, required — A GitHub user.
        - `name` string, nullable
        - `email` string, nullable
        - `login` string, required
        - `id` integer, required
        - `node_id` string, required
        - `avatar_url` string, uri, required
        - `gravatar_id` string, nullable, required
        - `url` string, uri, required
        - `html_url` string, uri, required
        - `followers_url` string, uri, required
        - `following_url` string, required
        - `gists_url` string, required
        - `starred_url` string, required
        - `subscriptions_url` string, uri, required
        - `organizations_url` string, uri, required
        - `repos_url` string, uri, required
        - `events_url` string, required
        - `received_events_url` string, uri, required
        - `type` string, required
        - `site_admin` boolean, required
        - `starred_at` string
        - `user_view_type` string
      - `private` boolean, required
      - `html_url` string, uri, required
      - `description` string, nullable, required
      - `fork` boolean, required
      - `url` string, uri, required
      - `archive_url` string, required
      - `assignees_url` string, required
      - `blobs_url` string, required
      - `branches_url` string, required
      - `collaborators_url` string, required
      - `comments_url` string, required
      - `commits_url` string, required
      - `compare_url` string, required
      - `contents_url` string, required
      - `contributors_url` string, uri, required
      - `deployments_url` string, uri, required
      - `downloads_url` string, uri, required
      - `events_url` string, uri, required
      - `forks_url` string, uri, required
      - `git_commits_url` string, required
      - `git_refs_url` string, required
      - `git_tags_url` string, required
      - `git_url` string
      - `issue_comment_url` string, required
      - `issue_events_url` string, required
      - `issues_url` string, required
      - `keys_url` string, required
      - `labels_url` string, required
      - `languages_url` string, uri, required
      - `merges_url` string, uri, required
      - `milestones_url` string, required
      - `notifications_url` string, required
      - `pulls_url` string, required
      - `releases_url` string, required
      - `ssh_url` string
      - `stargazers_url` string, uri, required
      - `statuses_url` string, required
      - `subscribers_url` string, uri, required
      - `subscription_url` string, uri, required
      - `tags_url` string, uri, required
      - `teams_url` string, uri, required
      - `trees_url` string, required
      - `clone_url` string
      - `mirror_url` string, nullable
      - `hooks_url` string, uri, required
      - `svn_url` string
      - `homepage` string, nullable
      - `language` string, nullable
      - `forks_count` integer
      - `stargazers_count` integer
      - `watchers_count` integer
      - `size` integer — The size of the repository, in kilobytes. Size is calculated hourly. When a repository is initially created, the size is 0.
      - `default_branch` string
      - `open_issues_count` integer
      - `is_template` boolean
      - `topics` string[]
      - `has_issues` boolean
      - `has_projects` boolean
      - `has_wiki` boolean
      - `has_pages` boolean
      - `has_downloads` boolean
      - `has_discussions` boolean
      - `has_pull_requests` boolean
      - `pull_request_creation_policy` 'all' | 'collaborators_only' — The policy controlling who can create pull requests: all or collaborators_only.
      - `archived` boolean
      - `disabled` boolean
      - `visibility` string
      - `pushed_at` string, date-time, nullable
      - `created_at` string, date-time, nullable
      - `updated_at` string, date-time, nullable
      - `permissions` object
        - `admin` boolean
        - `maintain` boolean
        - `push` boolean
        - `triage` boolean
        - `pull` boolean
      - `role_name` string
      - `temp_clone_token` string
      - `delete_branch_on_merge` boolean
      - `subscribers_count` integer
      - `network_count` integer
      - `code_of_conduct` CodeOfConduct — Code Of Conduct
        - `key` string, required
        - `name` string, required
        - `url` string, uri, required
        - `body` string
        - `html_url` string, uri, nullable, required
      - `license` object, nullable
        - `key` string
        - `name` string
        - `spdx_id` string
        - `url` string, nullable
        - `node_id` string
      - `forks` integer
      - `open_issues` integer
      - `watchers` integer
      - `allow_forking` boolean
      - `web_commit_signoff_required` boolean
      - `security_and_analysis` SecurityAndAnalysis, nullable
        - `advanced_security` object — Enable or disable GitHub Advanced Security for the repository. For standalone Code Scanning or Secret Protection products, this parameter cannot be used.
          - `status` 'enabled' | 'disabled'
        - `code_security` object
          - `status` 'enabled' | 'disabled'
        - `dependabot_security_updates` object — Enable or disable Dependabot security updates for the repository.
          - `status` 'enabled' | 'disabled' — The enablement status of Dependabot security updates for the repository.
        - `secret_scanning` object
          - `status` 'enabled' | 'disabled'
        - `secret_scanning_push_protection` object
          - `status` 'enabled' | 'disabled'
        - `secret_scanning_non_provider_patterns` object
          - `status` 'enabled' | 'disabled'
        - `secret_scanning_ai_detection` object
          - `status` 'enabled' | 'disabled'
        - `secret_scanning_delegated_alert_dismissal` object
          - `status` 'enabled' | 'disabled'
        - `secret_scanning_delegated_bypass` object
          - `status` 'enabled' | 'disabled'
        - `secret_scanning_delegated_bypass_options` object
          - `reviewers` object[] — The bypass reviewers for secret scanning delegated bypass
            - `reviewer_id` integer, required — The ID of the team or role selected as a bypass reviewer
            - `reviewer_type` 'TEAM' | 'ROLE', required — The type of the bypass reviewer
            - `mode` 'ALWAYS' | 'EXEMPT' — The bypass mode for the reviewer
      - `custom_properties` object — The custom properties that were defined for the repository. The keys are the custom property names, and the values are the corresponding custom property values.
    - `head_repository` MinimalRepository, required — Minimal Repository
      - `id` integer, required
      - `node_id` string, required
      - `name` string, required
      - `full_name` string, required
      - `owner` SimpleUser, required — A GitHub user.
        - `name` string, nullable
        - `email` string, nullable
        - `login` string, required
        - `id` integer, required
        - `node_id` string, required
        - `avatar_url` string, uri, required
        - `gravatar_id` string, nullable, required
        - `url` string, uri, required
        - `html_url` string, uri, required
        - `followers_url` string, uri, required
        - `following_url` string, required
        - `gists_url` string, required
        - `starred_url` string, required
        - `subscriptions_url` string, uri, required
        - `organizations_url` string, uri, required
        - `repos_url` string, uri, required
        - `events_url` string, required
        - `received_events_url` string, uri, required
        - `type` string, required
        - `site_admin` boolean, required
        - `starred_at` string
        - `user_view_type` string
      - `private` boolean, required
      - `html_url` string, uri, required
      - `description` string, nullable, required
      - `fork` boolean, required
      - `url` string, uri, required
      - `archive_url` string, required
      - `assignees_url` string, required
      - `blobs_url` string, required
      - `branches_url` string, required
      - `collaborators_url` string, required
      - `comments_url` string, required
      - `commits_url` string, required
      - `compare_url` string, required
      - `contents_url` string, required
      - `contributors_url` string, uri, required
      - `deployments_url` string, uri, required
      - `downloads_url` string, uri, required
      - `events_url` string, uri, required
      - `forks_url` string, uri, required
      - `git_commits_url` string, required
      - `git_refs_url` string, required
      - `git_tags_url` string, required
      - `git_url` string
      - `issue_comment_url` string, required
      - `issue_events_url` string, required
      - `issues_url` string, required
      - `keys_url` string, required
      - `labels_url` string, required
      - `languages_url` string, uri, required
      - `merges_url` string, uri, required
      - `milestones_url` string, required
      - `notifications_url` string, required
      - `pulls_url` string, required
      - `releases_url` string, required
      - `ssh_url` string
      - `stargazers_url` string, uri, required
      - `statuses_url` string, required
      - `subscribers_url` string, uri, required
      - `subscription_url` string, uri, required
      - `tags_url` string, uri, required
      - `teams_url` string, uri, required
      - `trees_url` string, required
      - `clone_url` string
      - `mirror_url` string, nullable
      - `hooks_url` string, uri, required
      - `svn_url` string
      - `homepage` string, nullable
      - `language` string, nullable
      - `forks_count` integer
      - `stargazers_count` integer
      - `watchers_count` integer
      - `size` integer — The size of the repository, in kilobytes. Size is calculated hourly. When a repository is initially created, the size is 0.
      - `default_branch` string
      - `open_issues_count` integer
      - `is_template` boolean
      - `topics` string[]
      - `has_issues` boolean
      - `has_projects` boolean
      - `has_wiki` boolean
      - `has_pages` boolean
      - `has_downloads` boolean
      - `has_discussions` boolean
      - `has_pull_requests` boolean
      - `pull_request_creation_policy` 'all' | 'collaborators_only' — The policy controlling who can create pull requests: all or collaborators_only.
      - `archived` boolean
      - `disabled` boolean
      - `visibility` string
      - `pushed_at` string, date-time, nullable
      - `created_at` string, date-time, nullable
      - `updated_at` string, date-time, nullable
      - `permissions` object
        - `admin` boolean
        - `maintain` boolean
        - `push` boolean
        - `triage` boolean
        - `pull` boolean
      - `role_name` string
      - `temp_clone_token` string
      - `delete_branch_on_merge` boolean
      - `subscribers_count` integer
      - `network_count` integer
      - `code_of_conduct` CodeOfConduct — Code Of Conduct
        - `key` string, required
        - `name` string, required
        - `url` string, uri, required
        - `body` string
        - `html_url` string, uri, nullable, required
      - `license` object, nullable
        - `key` string
        - `name` string
        - `spdx_id` string
        - `url` string, nullable
        - `node_id` string
      - `forks` integer
      - `open_issues` integer
      - `watchers` integer
      - `allow_forking` boolean
      - `web_commit_signoff_required` boolean
      - `security_and_analysis` SecurityAndAnalysis, nullable
        - `advanced_security` object — Enable or disable GitHub Advanced Security for the repository. For standalone Code Scanning or Secret Protection products, this parameter cannot be used.
          - `status` 'enabled' | 'disabled'
        - `code_security` object
          - `status` 'enabled' | 'disabled'
        - `dependabot_security_updates` object — Enable or disable Dependabot security updates for the repository.
          - `status` 'enabled' | 'disabled' — The enablement status of Dependabot security updates for the repository.
        - `secret_scanning` object
          - `status` 'enabled' | 'disabled'
        - `secret_scanning_push_protection` object
          - `status` 'enabled' | 'disabled'
        - `secret_scanning_non_provider_patterns` object
          - `status` 'enabled' | 'disabled'
        - `secret_scanning_ai_detection` object
          - `status` 'enabled' | 'disabled'
        - `secret_scanning_delegated_alert_dismissal` object
          - `status` 'enabled' | 'disabled'
        - `secret_scanning_delegated_bypass` object
          - `status` 'enabled' | 'disabled'
        - `secret_scanning_delegated_bypass_options` object
          - `reviewers` object[] — The bypass reviewers for secret scanning delegated bypass
            - `reviewer_id` integer, required — The ID of the team or role selected as a bypass reviewer
            - `reviewer_type` 'TEAM' | 'ROLE', required — The type of the bypass reviewer
            - `mode` 'ALWAYS' | 'EXEMPT' — The bypass mode for the reviewer
      - `custom_properties` object — The custom properties that were defined for the repository. The keys are the custom property names, and the values are the corresponding custom property values.
    - `head_repository_id` integer
    - `display_title` string, required — The event-specific title associated with the run or the run-name if set, or the value of `run-name` if it is set in the workflow.

---

[API](https://skmtc.net/github/apis/rest-api.md) · [All operations](https://skmtc.net/github/apis/rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/github/rest-api/versions/80850db290cd/schema)