NAME

       gh-search-prs - Search for pull requests

SYNOPSIS

       gh search prs [<query>] [flags]

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⟩

OPTIONS

       --app <string>
              Filter by GitHub App author

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

       --assignee <string>
              Filter by assignee

       --author <string>
              Filter by author

       -B, --base <string>
              Filter on base branch name

       --checks <string>
              Filter based on status of the checks: {pending|success|failure}

       --closed <date>
              Filter on closed at date

       --commenter <user>
              Filter based on comments by user

       --comments <number>
              Filter on number of comments

       --created <date>
              Filter based on created at date

       --draft
              Filter based on draft state

       -H, --head <string>
              Filter on head branch name

       --interactions <number>
              Filter on number of reactions and comments

       --involves <user>
              Filter based on involvement of user

       -q, --jq <expression>
              Filter JSON output using a jq expression

       --json <fields>
              Output JSON with the specified fields

       --label <strings>
              Filter on label

       --language <string>
              Filter based on the coding language

       -L, --limit <int> (default 30)
              Maximum number of results to fetch

       --locked
              Filter on locked conversation status

       --match <strings>
              Restrict search to specific field of issue: {title|body|comments}

       --mentions <user>
              Filter based on user mentions

       --merged
              Filter based on merged state

       --merged-at <date>
              Filter on merged at date

       --milestone <title>
              Filter by milestone title

       --no-assignee
              Filter on missing assignee

       --no-label
              Filter on missing label

       --no-milestone
              Filter on missing milestone

       --no-project
              Filter on missing project

       --order <string> (default "desc")
              Order of results returned, ignored unless '--sort' flag is specified: {asc|desc}

       --owner <strings>
              Filter on repository owner

       --project <number>
              Filter on project board number

       --reactions <number>
              Filter on number of reactions

       -R, --repo <strings>
              Filter on repository

       --review <string>
              Filter based on review status: {none|required|approved|changes_requested}

       --review-requested <user>
              Filter on user or team requested to review

       --reviewed-by <user>
              Filter on user who reviewed

       --sort <string> (default "best-match")
              Sort  fetched  results:   {comments|reactions|reactions-+1|reactions--1|reactions-smile|reactions-
              thinking_face|reactions-heart|reactions-tada|interactions|created|updated}

       --state <string>
              Filter based on state: {open|closed}

       --team-mentions <string>
              Filter based on team mentions

       -t, --template <string>
              Format JSON output using a Go template; see "gh help formatting"

       --updated <date>
              Filter on last updated at date

       --visibility <strings>
              Filter based on repository visibility: {public|private|internal}

       -w, --web
              Open the search query in the web browser

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 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

       gh-search(1)

                                                    Jul 2025                                    GH-SEARCH-PRS(1)