gh pr list List pull requests in a repository

Shows open pull requests with number, title, branch and state. Filters narrow the list, and it can print JSON for scripts.

Synopsis

gh pr list [FLAGS]

Common options

Option or formWhat it does
-s, --state open|closed|merged|allWhich state to show (default open)
-a, --assignee USEROnly those assigned to someone (@me for yourself)
-A, --author USEROnly those opened by someone
-l, --label NAMEOnly those with a label
-L, --limit NMaximum number to list (default 30)
--json FIELDSOutput the named fields as JSON
-S, --search QUERYFilter with GitHub search syntax

Examples

See open pull requests
gh pr list
#42  Add search       feature/search  about 2 hours ago
See your own
gh pr list --author "@me"
Show merged ones
gh pr list --state merged --limit 10
Pull requests waiting on review
gh pr list --search "review:required"
Get numbers and titles as JSON
gh pr list --json number,title

Notes

See also

Last reviewed 2026-10-09.