# gh pr list

List and filter pull requests.

## Quick answer
```
gh pr list
```

## Syntax
```
gh pr list [flags]
```

## Examples

# List open PRs in the current repo
gh pr list

# Only your own pull requests
gh pr list --author @me

# Merged PRs with a specific label
gh pr list --state merged --label bug

# PRs targeting a release branch
gh pr list --base release-2.0

# Search with GitHub's query syntax
gh pr list --search "review:required draft:false"

# Machine-readable output for scripts
gh pr list --json number,title,author --limit 100

## Key flags

  -s, --state	Filter by state: open (default), closed, merged, or all.
  -A, --author	Filter by author login. Use @me for yourself.
  -a, --assignee	Filter by assignee.
  -l, --label	Filter by label (repeatable).
  -B, --base	Filter by base branch.
  -S, --search	Search PRs with GitHub search syntax.
  -L, --limit	Maximum number of items to fetch (default 30).
  --json	Output specified fields as JSON for scripting.
  -w, --web	Open the filtered list on github.com.

Full guide: https://ghcli.com/gh-pr-list.php