GH-SEARCH-PRS(1) GitHub CLI manual GH-SEARCH-PRS(1)

# [NAME](#NAME)

gh-search-prs - Search for pull requests

# [SYNOPSIS](#SYNOPSIS)

**gh search prs \[<query>] \[flags]**

# [DESCRIPTION](#DESCRIPTION)

Search for pull requests on GitHub.

The command supports constructing queries using the GitHub search syntax, using the parameter and qualifier flags, or a combination of the two.

GitHub search syntax is documented at:

⟨https://docs.github.com/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⟩

For more information on handling search queries containing a hyphen, run **gh search --help**.

# [OPTIONS](#OPTIONS)

[**--app** **<string>**](#app)

Filter by GitHub App author

[**--archived**](#archived)

Filter based on the repository archived state {true|false}

[**--assignee** **<string>**](#assignee)

Filter by assignee

[**--author** **<string>**](#author)

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

[**-B**, **--base** **<string>**](#B)

Filter on base branch name

[**--checks** **<string>**](#checks)

Filter based on status of the checks: {pending|success|failure}

[**--closed** **<date>**](#closed)

Filter on closed at date

[**--commenter** **<user>**](#commenter)

Filter based on comments by user

[**--comments** **<number>**](#comments)

Filter on number of comments

[**--created** **<date>**](#created)

Filter based on created at date

[**--draft**](#draft)

Filter based on draft state

[**-H**, **--head** **<string>**](#H)

Filter on head branch name

[**--interactions** **<number>**](#interactions)

Filter on number of reactions and comments

[**--involves** **<user>**](#involves)

Filter based on involvement of user

[**-q**, **--jq** **<expression>**](#q)

Filter JSON output using a jq expression

[**--json** **<fields>**](#json)

Output JSON with the specified fields

[**--label** **<strings>**](#label)

Filter on label

[**--language** **<string>**](#language)

Filter based on the coding language

[**-L**, **--limit** **<int> (default 30)**](#L)

Maximum number of results to fetch

[**--locked**](#locked)

Filter on locked conversation status

[**--match** **<strings>**](#match)

Restrict search to specific field of issue: {title|body|comments}

[**--mentions** **<user>**](#mentions)

Filter based on user mentions

[**--merged**](#merged)

Filter based on merged state

[**--merged-at** **<date>**](#merged_at)

Filter on merged at date

[**--milestone** **<title>**](#milestone)

Filter by milestone title

[**--no-assignee**](#no_assignee)

Filter on missing assignee

[**--no-label**](#no_label)

Filter on missing label

[**--no-milestone**](#no_milestone)

Filter on missing milestone

[**--no-project**](#no_project)

Filter on missing project

[**--order** **<string> (default "desc")**](#order)

Order of results returned, ignored unless '--sort' flag is specified: {asc|desc}

[**--owner** **<strings>**](#owner)

Filter on repository owner

[**--project** **<owner/number>**](#project)

Filter on project board owner/number

[**--reactions** **<number>**](#reactions)

Filter on number of reactions

[**-R**, **--repo** **<OWNER/REPO>**](#R)

Filter on repository, in OWNER/REPO format

[**--review** **<string>**](#review)

Filter based on review status: {none|required|approved|changes\_requested}

[**--review-requested** **<user>**](#review_requested)

Filter on user or team requested to review

[**--reviewed-by** **<user>**](#reviewed_by)

Filter on user who reviewed

[**--sort** **<string> (default "best-match")**](#sort)

Sort fetched results: {comments|reactions|reactions-+1|reactions--1|reactions-smile|reactions-thinking\_face|reactions-heart|reactions-tada|interactions|created|updated}

[**--state** **<string>**](#state)

Filter based on state: {open|closed}

[**--team-mentions** **<string>**](#team_mentions)

Filter based on team mentions

[**-t**, **--template** **<string>**](#t)

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

[**--updated** **<date>**](#updated)

Filter on last updated at date

[**--visibility** **<strings>**](#visibility)

Filter based on repository visibility: {public|private|internal}

[**-w**, **--web**](#w)

Open the search query in the web browser

# [JSON FIELDS](#JSON_FIELDS)

**assignees**, **author**, **authorAssociation**, **body**, **closedAt**, **commentsCount**, **createdAt**, **id**, **isDraft**, **isLocked**, **isPullRequest**, **labels**, **number**, **repository**, **state**, **title**, **updatedAt**, **url**

# [EXIT CODES](#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](#EXAMPLE)

```
# Search pull requests matching set of keywords "fix" and "bug"
$ gh search prs fix bug
# Search draft pull requests in cli repository
$ gh search prs --repo=cli/cli --draft
# Search pull requests using raw search qualifiers as separate arguments
$ gh search prs is:merged author:monalisa
# Search open pull requests requesting your review
$ gh search prs --review-requested=@me --state=open
# Search merged pull requests assigned to yourself
$ gh search prs --assignee=@me --merged
# Search pull requests with numerous reactions
$ gh search prs --reactions=">100"
# Search pull requests without label "bug"
$ gh search prs -- -label:bug
# Search pull requests only from un-archived repositories (default is all repositories)
$ gh search prs --owner github --archived=false
```

# [SEE ALSO](#SEE_ALSO)

[**gh-search(1)**](/man/os/gh/gh-search.1)

Sep 2026

---

Document: gh-search-prs(1) from gh 2.101.0-r1 (Chainguard OS)
Source: https://github.com/cli/cli