Skip to main content
GET
List the organization's pull requests

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

orgID
string<uuid>
required

Query Parameters

view
enum<string>

reviews keeps the pull requests the organization's review runs reviewed, newest activity first (the later of the newest run and the merge); queue keeps the open ones among them, the ones whose newest run or posted verdict needs the caller first. Omitted is every pull request of a repository the organization has a non-archived project for, reviewed or not, newest opened first as GitHub orders them.

Available options:
reviews,
queue
project_id
string<uuid>

Keeps the pull requests of this project's repository, and the review runs of this project.

status
string

Comma-joined review-run statuses, matched against the latest run, the status the row displays; unreviewed matches a pull request with no runs, and only without a view.

Pattern: ^(reviewing|completed|failed|cancelled|superseded|archived|unreviewed)(,(reviewing|completed|failed|cancelled|superseded|archived|unreviewed))*$
pr_state
string

Comma-joined pull request states to keep; a pull request whose state the mirror has not recorded is in none. Omitted without a view is open alone.

Pattern: ^(open|closed|merged)(,(open|closed|merged))*$
viewer
enum<string>

author keeps the pull requests the caller opened, by the GitHub login their connection stores or by one of their tasks publishing it; involved adds the ones they review, by that login.

Available options:
author,
involved
author
string

The GitHub login that opened the pull request, case-insensitively.

Pattern: ^[A-Za-z0-9][A-Za-z0-9_-]*(\[[bB][oO][tT]\])?$
reviewer
string

A GitHub login with a user review request or a submitted review on the pull request, never its author, case-insensitively.

Pattern: ^[A-Za-z0-9][A-Za-z0-9_-]*(\[[bB][oO][tT]\])?$
repo_owner
string

The repository owner's login, case-insensitively.

Pattern: ^[A-Za-z0-9][A-Za-z0-9_-]*(\[[bB][oO][tT]\])?$
repo_name
string

The repository name, case-insensitively.

Pattern: ^[A-Za-z0-9._-]+$
opened_after
string<date-time>

Keeps pull requests opened at or after this UTC instant; one mirrored before Aether kept GitHub's open time is dated by when Aether first saw it.

Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,6})?Z$
opened_before
string<date-time>

Keeps pull requests opened before this UTC instant; later than opened_after.

Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,6})?Z$
updated_after
string<date-time>

Keeps pull requests GitHub last updated at or after this UTC instant.

Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,6})?Z$
updated_before
string<date-time>

Keeps pull requests GitHub last updated before this UTC instant; later than updated_after.

Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,6})?Z$
drafts
enum<string>

exclude leaves draft pull requests out.

Available options:
exclude
q
string

Trimmed; empty is no search. All digits, or # and digits, keeps the pull request with that number; anything else keeps the pull requests whose title holds its words in order, case-insensitively. Over 200 characters, or a number beyond a pull request number's range, is refused.

section
enum<string>

Keeps one section in the list's order; a cursor from any page of the same list pages inside it.

Available options:
in_review,
approved,
other
limit
integer<int64>

Pull requests per page; 20 when omitted.

Required range: 1 <= x <= 100
cursor
string

The previous page's next_cursor. A cursor minted for another view, organization, filter set or search is refused.

Response

OK

items
object[]
required
next_cursor
string | null
required
Minimum string length: 1