From 2cf2fa924c84bb83db72a66646250367dbc5923d Mon Sep 17 00:00:00 2001
From: Josh Soref <2119212+jsoref@users.noreply.github.com>
Date: Sat, 7 Feb 2026 20:19:11 -0500
Subject: [PATCH] Document `status:success`, `status:failure`, and
 `status:pending`

---
 .../filtering-and-searching-issues-and-pull-requests.md        | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/content/issues/tracking-your-work-with-issues/using-issues/filtering-and-searching-issues-and-pull-requests.md b/content/issues/tracking-your-work-with-issues/using-issues/filtering-and-searching-issues-and-pull-requests.md
index 785392c0f956..c31d965c80b1 100644
--- a/content/issues/tracking-your-work-with-issues/using-issues/filtering-and-searching-issues-and-pull-requests.md
+++ b/content/issues/tracking-your-work-with-issues/using-issues/filtering-and-searching-issues-and-pull-requests.md
@@ -242,6 +242,9 @@ For pull requests, you can also use search to:
 * Filter pull requests that someone has asked you directly to review: `state:open is:pr user-review-requested:@me`
 * Filter pull requests by the team requested for review: `state:open is:pr team-review-requested:github/docs`
 * Filter for pull requests that are linked to an issue that the pull request may close: `linked:issue`
+* Filter pull requests where all statuses are successful: `status:success`
+* Filter pull requests with at least one error or failure status: `status:failure`
+* Filter pull requests with no statuses or at least one status in the pending state: `status:pending`
 * Filter pull requests by state of [merging](/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/about-pull-request-merges): `is:merged` or `is:unmerged`
 
 ## Sorting issues and pull requests