Scroll to navigation

GH-PR-LIST(1) GitHub CLI manual GH-PR-LIST(1)

NAME

gh-pr-list - List pull requests in a repository

SYNOPSIS

gh pr list [flags]

DESCRIPTION

List pull requests in a GitHub repository.

The search query syntax is documented here:

⟨https://docs.github.com/en/search-github/searching-on-github/searching-issues-and-pull-requests⟩

OPTIONS

Filter by GitHub App author

Filter by assignee

Filter by author

Filter by base branch

Filter by draft state

Filter by head branch

Filter JSON output using a jq expression

Output JSON with the specified fields

Filter by label

Maximum number of items to fetch

Search pull requests with query

Filter by state: {open|closed|merged|all}

Format JSON output using a Go template; see "gh help formatting"

List pull requests in the web browser

OPTIONS INHERITED FROM PARENT COMMANDS

Select another repository using the [HOST/]OWNER/REPO format

ALIASES

gh pr ls

JSON FIELDS

additions, assignees, author, autoMergeRequest, baseRefName, baseRefOid, body, changedFiles, closed, closedAt, comments, commits, createdAt, deletions, files, fullDatabaseId, headRefName, headRefOid, headRepository, headRepositoryOwner, id, isCrossRepository, isDraft, labels, latestReviews, maintainerCanModify, mergeCommit, mergeStateStatus, mergeable, mergedAt, mergedBy, milestone, number, potentialMergeCommit, projectCards, projectItems, reactionGroups, reviewDecision, reviewRequests, reviews, state, statusCheckRollup, title, updatedAt, url

EXIT CODES

0: Successful execution

1: Error

2: Command canceled

4: Authentication required

NOTE: Specific commands may have additional exit codes. Refer to the command's help for more information.

EXAMPLE

List PRs authored by you
$ gh pr list --author "@me"
List only PRs with all of the given labels
$ gh pr list --label bug --label "priority 1"
Filter PRs using search syntax
$ gh pr list --search "status:success review:required"
Find a PR that introduced a given commit
$ gh pr list --search "<SHA>" --state merged

SEE ALSO

gh-pr(1)

Jan 2025 GitHub CLI v2.65.0