git.pulls.listList pull requests
Request syntax
GET /git/api/repositories/{repoId}/pullsPath parameters
repoIdRequiredstring
Constraints: uuid
Query parameters
stateOptionalenum
Only pull requests in this state; every state when absent
One of:
open,closed,merged,draftauthorOptionalstring
Opened by this IAM username, or for an imported pull request this login on the source; `@me` for the caller
Constraints: 1-200 chars
assigneeOptionalstring
Assigned to this IAM username; `@me` for the caller
Constraints: 1-200 chars
reviewerOptionalstring
Review requested from, or given by, this IAM username; `@me` for the caller
Constraints: 1-200 chars
labelOptionalstring
Carries this label; `@me` for the caller
Constraints: 1-200 chars
mentionsOptionalobject
Only pull requests whose description or comments mention the caller
Constraints: JSON
sortOptionalenum
Default: by number, newest first; `comments` puts the most commented first
One of:
newest,oldest,updated,comments
Response
200 with the pull requests (number, title, body, state, branches, mergeStatus, author, auto-merge and the merge and close times); by number, newest first, unless `sort` says otherwise.
A JSON response is wrapped as { "success": true, "data": … }; the CLI prints the whole body with --json.
Fields of data
[].idAlwaysstring
The pull request id[].orgIdAlwaysstring
The organization that owns it[].repoIdAlwaysstring
The repository it belongs to[].numberAlwaysnumber
Its number in the repository, as in #12[].titleAlwaysstring
The title[].bodyAlwaysstring, may be null
The description (Markdown); null when there is none[].stateAlwaysone of open, closed, merged, draft
open, draft, closed (without merging) or merged[].sourceBranchAlwaysstring
The branch with the changes[].targetBranchAlwaysstring
The branch it merges into[].sourceOidAlwaysstring, may be null
Head commit of the source branch when mergeability was last computed[].targetOidAlwaysstring, may be null
Tip of the target branch when mergeability was last computed[].mergeStatusAlwaysone of unknown, mergeable, conflicted, up_to_date
Whether it merges cleanly: mergeable, conflicted, up_to_date (nothing to merge) or unknown[].mergeConflictsAlwaysarray of string, may be null
The conflicting paths when conflicted; null when not known[].mergeCommitOidAlwaysstring, may be null
The commit the merge produced; null until merged[].authorIamUserIdAlwaysstring
The IAM user who opened it (for an imported one, who ran the import)[].isDraftAlwaysboolean
A draft, not yet ready for review[].mergedAtAlwaysstring, may be null
When it was merged; null unless merged[].closedAtAlwaysstring, may be null
When it was closed; null while open[].externalAuthorAlwaysstring, may be null
For an imported pull request, who opened it at the source; null otherwise[].externalUrlAlwaysstring, may be null
For an imported pull request, its address at the source; null otherwise[].autoMergeMethodAlwaysone of merge, squash, rebase, may be null
The method auto-merge will use; null when auto-merge is off[].autoMergeIamUserIdAlwaysstring, may be null
Who turned auto-merge on, and as whom it merges; null when off[].autoMergeEnabledAtAlwaysstring, may be null
When auto-merge was turned on; null when off[].autoMergeBlockedReasonAlwaysstring, may be null
Why the last auto-merge attempt did not merge; null when nothing blocks it[].createdAtAlwaysstring
When it was opened[].updatedAtAlwaysstring
When it last changed
Checked against the handlers: every route test validates their answers against this schema.
Errors
- 400The request does not pass the schema above. The body is { "error": …, "issues": […] }, one issue per field.
- 401No credentials, or an access key that is unknown, revoked or expired.
- 403The caller's policies do not allow git:ListPullRequests on this resource. The body names the action and the resource, and the refusal is recorded in the audit log.
- 404The resource does not exist in your organization.
Examples
The required parameters only, with example values. Replace id and the other placeholders with your own.
dcloud git pulls list repoIdcurl -X GET "https://console.platform-development.deutschecloud.app/git/api/repositories/repoId/pulls" \
-H "Authorization: EWS-ACCESS-KEY $ACCESS_KEY"Generated from the API description, the same one the API checks requests against and the CLI is built from. MCP tool: dcloud_git_pulls_list.