# List pull requests in account/org/project

Endpoint: GET /code/api/v1/pullreq
Version: 1.0
Security: x-api-key

## Query parameters:

  - `accountIdentifier` (string, required)
    Account Identifier for the Entity.

  - `orgIdentifier` (string)
    Organization Identifier for the Entity.

  - `projectIdentifier` (string)
    Project Identifier for the Entity.

  - `state` (array)
    The state of the pull requests to include in the result.
    Enum: "closed", "merged", "open"

  - `source_repo_ref` (string)
    Source repository ref of the pull requests.

  - `source_branch` (string)
    Source branch of the pull requests.

  - `target_branch` (string)
    Target branch of the pull requests.

  - `query` (string)
    The substring by which the pull requests are filtered.

  - `created_by` (array)
    List of principal IDs who created pull requests.

  - `created_lt` (integer)
    The result should contain only entries created before this timestamp (unix millis).

  - `created_gt` (integer)
    The result should contain only entries created after this timestamp (unix millis).

  - `updated_lt` (integer)
    The result should contain only entries updated before this timestamp (unix millis).

  - `exclude_description` (boolean)
    By providing this parameter the description would be excluded from the response.

  - `include_subspaces` (boolean)
    The result should contain entries from the desired space and of its subspaces.

  - `limit` (integer)
    The maximum number of results to return.

  - `label_id` (array)
    List of label ids used to filter pull requests.

  - `value_id` (array)
    List of label value ids used to filter pull requests.

  - `author_id` (integer)
    Return only pull requests where this user is the author.

  - `commenter_id` (integer)
    Return only pull requests where this user has created at least one comment.

  - `mentioned_id` (integer)
    Return only pull requests where this user has been mentioned.

  - `reviewer_id` (integer)
    Return only pull requests where this user has been added as a reviewer.

  - `review_decision` (array)
    Require only this review decision of the reviewer. Requires reviewer_id parameter.
    Enum: "approved", "changereq", "pending", "reviewed"

  - `include_git_stats` (boolean)
    If true, the git diff stats would be included in the response.

  - `include_checks` (boolean)
    If true, the summary of check for the branch commit SHA would be included in the response.

  - `include_rules` (boolean)
    If true, a list of rules that apply to this branch would be included in the response.

## Response 200 fields (application/json):

  - `pull_request` (object)

  - `pull_request.author` (object,null)

  - `pull_request.author.created` (integer)

  - `pull_request.author.display_name` (string)

  - `pull_request.author.email` (string)

  - `pull_request.author.id` (integer)

  - `pull_request.author.type` (string)
    Enum: "service", "serviceaccount", "user"

  - `pull_request.author.uid` (string)

  - `pull_request.author.updated` (integer)

  - `pull_request.check_summary` (object)

  - `pull_request.check_summary.error` (integer)

  - `pull_request.check_summary.failure` (integer)

  - `pull_request.check_summary.pending` (integer)

  - `pull_request.check_summary.running` (integer)

  - `pull_request.check_summary.success` (integer)

  - `pull_request.closed` (integer,null)

  - `pull_request.description` (string)

  - `pull_request.edited` (integer)

  - `pull_request.is_draft` (boolean)

  - `pull_request.labels` (array)

  - `pull_request.labels.color` (string)
    Enum: "blue", "brown", "cyan", "green", "indigo", "lime", "mint", "orange", "pink", "purple", "red", "violet", "yellow"

  - `pull_request.labels.key` (string)

  - `pull_request.labels.scope` (integer)

  - `pull_request.labels.value` (string,null)

  - `pull_request.labels.value_color` (string)
    Enum: "blue", "brown", "cyan", "green", "indigo", "lime", "mint", "orange", "pink", "purple", "red", "violet", "yellow"

  - `pull_request.labels.value_count` (integer)

  - `pull_request.labels.value_id` (integer,null)

  - `pull_request.merge_base_sha` (string)

  - `pull_request.merge_check_status` (string)

  - `pull_request.merge_conflicts` (array)

  - `pull_request.merge_method` (string)
    Enum: "fast-forward", "merge", "rebase", "squash"

  - `pull_request.merge_target_sha` (string,null)

  - `pull_request.merge_violations_bypassed` (boolean,null)

  - `pull_request.merged` (integer,null)

  - `pull_request.merger` (object,null)

  - `pull_request.number` (integer)

  - `pull_request.rebase_check_status` (string)

  - `pull_request.rebase_conflicts` (array)

  - `pull_request.rules` (array)

  - `pull_request.rules.identifier` (string)

  - `pull_request.rules.repo_path` (string)

  - `pull_request.rules.space_path` (string)

  - `pull_request.rules.state` (string,null)
    Enum: "active", "disabled", "monitor"

  - `pull_request.source_branch` (string)

  - `pull_request.source_repo_id` (integer)

  - `pull_request.source_sha` (string)

  - `pull_request.stats` (object)

  - `pull_request.stats.additions` (integer,null)

  - `pull_request.stats.commits` (integer,null)

  - `pull_request.stats.conversations` (integer)

  - `pull_request.stats.deletions` (integer,null)

  - `pull_request.stats.files_changed` (integer,null)

  - `pull_request.stats.unresolved_count` (integer)

  - `pull_request.target_branch` (string)

  - `pull_request.target_repo_id` (integer)

  - `pull_request.title` (string)

  - `repository` (object,null)

  - `repository.default_branch` (string)

  - `repository.parent_id` (integer)

  - `repository.path` (string)

## Response 400 fields (application/json):

  - `message` (string)

  - `values` (object)

## Response 401 fields (application/json):

  - `message` (string)

  - `values` (object)

## Response 403 fields (application/json):

  - `message` (string)

  - `values` (object)

## Response 500 fields (application/json):

  - `message` (string)

  - `values` (object)