---
name: "gh-pr-list"
section: "1"
platform: "linux"
package: "github-cli"
version: "2.102.1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/gh-pr-list"
---

# gh-pr-list(1)

List pull requests in a repository

## NAME

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

## SYNOPSIS

**gh pr list \[flags\]**

## DESCRIPTION

List pull requests in a GitHub repository. By default, this only lists open PRs.

The search query syntax is documented here:

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

On supported GitHub hosts, advanced issue search syntax can be used in the **--search** query. For more information about advanced issue search, see:

⟨https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/filtering-and-searching-issues-and-pull-requests#building-advanced-filters-for-issues⟩

## OPTIONS

- **--app** **\<string\>**

  Filter by GitHub App author

- **-a**, **--assignee** **\<string\>**

  Filter by assignee

- **-A**, **--author** **\<string\>**

  Filter by author (use --app to filter by a GitHub App)

- **-B**, **--base** **\<string\>**

  Filter by base branch

- **-d**, **--draft**

  Filter by draft state

- **-H**, **--head** **\<string\>**

  Filter by head branch (":" syntax not supported)

- **-q**, **--jq** **\<expression\>**

  Filter JSON output using a jq expression

- **--json** **\<fields\>**

  Output JSON with the specified fields

- **-l**, **--label** **\<strings\>**

  Filter by label

- **-L**, **--limit** **\<int\> (default 30)**

  Maximum number of items to fetch

- **-S**, **--search** **\<query\>**

  Search pull requests with query

- **-s**, **--state** **\<string\> (default "open")**

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

- **-t**, **--template** **\<string\>**

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

- **-w**, **--web**

  List pull requests in the web browser

## OPTIONS INHERITED FROM PARENT COMMANDS

- **-R**, **--repo** **\<\[HOST/\]OWNER/REPO\>**

  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**, **closingIssuesReferences**, **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 PRs opened by a GitHub App such as Dependabot
$ gh pr list --app dependabot
# List PRs with a specific head branch name
$ gh pr list --head "typo"
# 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)](/gh-pr/1.md)**