Skip to main content
GET
TypeScript SDK

Authorizations

Authorization
string
header
required

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

Query Parameters

authorIds
string[]

Filter authors by comma-separated provider:identifier values, such as github:octocat.

Minimum string length: 1
createdAfter
string<date-time>

Only pull requests created after this ISO 8601 timestamp.

cursor
string<uuid>

Continuation cursor from the previous response nextCursor. Omit for the first page; null nextCursor means there are no more pages.

limit
integer
default:50

Maximum number of items to return in one page. Use nextCursor from the response to fetch more items.

Required range: 1 <= x <= 100
excludeAuthorIds
string[]

Exclude authors by comma-separated provider:identifier values.

Minimum string length: 1
excludeOrganizationName
string

Exclude pull requests from the named organization within the caller access scope.

Minimum string length: 1
excludeReturnedAuthorIds
string[]

Exclude returned pull requests by these comma-separated provider:identifier author values.

Minimum string length: 1
excludeReviewerIds
string[]

Exclude pull requests assigned to these comma-separated reviewer identifiers.

Minimum string length: 1
hasTemboSession
boolean

When true, only return pull requests with a linked Tembo session.

includeAuthors
boolean

Request author filter options. Public responses do not include organization-wide author options.

includeTotal
boolean

Include the total count of matching pull requests.

includeStacks
boolean

Include each open pull request's position in its stack of dependent pull requests. Public responses do not include stacks.

repositoryIds
string[]

Filter by repository IDs, supplied as a comma-separated list.

Minimum string length: 1
reviewerIds
string[]

Filter by assigned reviewer identifiers, supplied as a comma-separated list.

Minimum string length: 1
mergedAfter
string<date-time>

Only pull requests merged after this ISO 8601 timestamp.

Search pull requests.

Minimum string length: 1
sortBy
enum<string>

Sort by creation time or last update time.

Available options:
createdAt,
updatedAt
state
enum<string>

Filter by lifecycle or review state, including open, returned, approved, needs review, draft, merged, or closed.

Available options:
open,
returned,
approved,
needs review,
draft,
merged,
closed
updatedAfter
string<date-time>

Only pull requests updated after this ISO 8601 timestamp.

Response

List pull requests

items
object[]
required
nextCursor
string<uuid> | null
required
totalCount
integer
Required range: x >= 0