Addon
Branch restrictions
Branching model
Commit statuses
Commits
Deployments
Downloads
Issue tracker
Pipelines
Projects
Pullrequests
Refs
Reports
Repositories
Snippets
Source
Ssh
Users
Webhooks
Workspaces
Other operations

Rate this page:

Pullrequests

Pull requests are a feature that makes it easier for developers to collaborate using Bitbucket. They provide a user-friendly web interface for discussing proposed changes before integrating them into the official project.

List pull requests for a user

GET /2.0/pullrequests/{selected_user}

Returns all pull requests authored by the specified user.

By default only open pull requests are returned. This can be controlled using the state query parameter. To retrieve pull requests that are in one of multiple states, repeat the state parameter for each individual state.

This endpoint also supports filtering and sorting of the results. See filtering and sorting for more details.

pullrequest

Request

Path parameters
selected_user Required

string

This can either be the username of the pull request author, the author's UUID surrounded by curly-braces, for example: {account UUID}, or the author's Atlassian ID.

Query parameters
state

string

Only return pull requests that are in this state. This parameter can be repeated.

Valid values: OPEN, MERGED, DECLINED, SUPERSEDED

Example

1
2
3
4
curl --request GET \
  --url 'https://api.bitbucket.org/2.0/pullrequests/{selected_user}' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Accept: application/json'

Responses