pulls/pulls list-pull-requests doesn't list 404 as a response #43690
Description
Code of Conduct
- I have read and agree to the GitHub Docs project's Code of Conduct
What article on docs.github.com is affected?
https://docs.github.com/rest/pulls/pulls#list-pull-requests
What part(s) of the article would you like to see updated?
https://docs.github.com/en/rest/pulls/pulls?apiVersion=2026-03-10#list-pull-requests--status-codes
HTTP response status codes for "List pull requests"
| Status code | Description |
|---|---|
| 200 | OK |
| 304 | Not modified |
| 422 | Validation failed, or the endpoint has been spammed. |
Should mention 404 or something should explain why 404 isn't covered
Additional information
Request for 'https://api.github.com/repos/check-spelling/check-spelling-docs/pulls?head=check-spelling:refs/heads/main' appears to have yielded an error, it is probably an authentication error.
Headers
HTTP/2 404
date: Mon, 06 Apr 2026 16:48:18 GMT
content-type: application/json; charset=utf-8
content-length: 134
x-github-media-type: github.v3; format=json
x-accepted-github-permissions: pull_requests=read
x-github-api-version-selected: 2022-11-28
access-control-expose-headers: ETag, Link, Location, Retry-After, X-GitHub-OTP, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Used, X-RateLimit-Resource, X-RateLimit-Reset, X-OAuth-Scopes, X-Accepted-OAuth-Scopes, X-Poll-Interval, X-GitHub-Media-Type, X-GitHub-SSO, X-GitHub-Request-Id, Deprecation, Sunset
access-control-allow-origin: *
strict-transport-security: max-age=31536000; includeSubdomains; preload
x-frame-options: deny
x-content-type-options: nosniff
x-xss-protection: 0
referrer-policy: origin-when-cross-origin, strict-origin-when-cross-origin
content-security-policy: default-src 'none'
vary: Accept-Encoding, Accept, X-Requested-With
x-github-request-id: B804:11D87C:AC4126:2BB8D5F:69D3E3D2
server: github.com
x-ratelimit-limit: 5000
x-ratelimit-remaining: 4998
x-ratelimit-reset: 1775497698
x-ratelimit-used: 2
x-ratelimit-resource: core
Response
{
"message": "Not Found",
"documentation_url": "https://docs.github.com/rest/pulls/pulls#list-pull-requests",
"status": "404"
}https://docs.github.com/en/rest/pulls/pulls?apiVersion=2026-03-10#list-pull-requests says:
Query parameters
head string
Filter pulls by head user or head organization and branch name in the format of user:ref-name or organization:ref-name. For example: github:new-script-format or octocat:test-branch.
Note that https://api.github.com/repos/check-spelling/check-spelling-docs/pulls?head=check-spelling:main doesn't yield a 200 either.