ListMergeRequestsResponse
Shape
itemsarray of MergeRequest
- The MergeRequest schema
- created_atstring
- created_byPrincipalId (string · uuid)The person or agent who opened it.
- is_draftboolean
- merge_request_idMergeRequestId (integer · int64)
- repository_idRepositoryId (string · uuid)
- source_branchBranchName (string)
- source_branch_deletedboolean
- source_branch_headCommitHash (string)
- statusMergeRequestStatusopenmergedclosed
- target_branchBranchName (string)
- target_branch_headCommitHash (string)
- titleMrTitle (string)
- updated_atstring
- author_can_pushboolean or nulloptionalWhether the author can push to the repository — false for a drive-by contributor's merge request. Absent where it was not computed.
- closed_atstring or nulloptional
- closed_byPrincipalId (string · uuid) or nulloptional
- descriptionMrDescription (string) or nulloptional
- merge_commit_shaCommitHash (string) or nulloptional
- merged_atstring or nulloptional
- merged_byPrincipalId (string · uuid) or nulloptional
- restack_requiredbooleanoptionalPrecise restack signal — set when this MR's downstack was squash-merged (a rebase is genuinely required to drop the duplicated diff). Distinct from the advisory
commits_behind. Reset on the MR's next source-advancing write. stack_summaryStackSummary or nulloptionalThe neighbouring merge requests in this stack. Returned when fetching a single merge request, not in listings.
- The StackSummary schema
- has_downstackboolean
- has_upstackboolean
- downstack_mr_idMergeRequestId (integer · int64) or nulloptional
- upstack_mr_idsarray of MergeRequestId (integer · int64)optional
- versioninteger · int64optional0–∞Optimistic-concurrency counter. Bumped on every write; writes condition on the read value.
- next_tokenstring or nulloptional
Example
Synthesized example{
"items": [
{
"created_at": "2026-10-08T13:03:19Z",
"created_by": "c9d8e7f6-a5b4-4c3d-9e2f-1a0b9c8d7e6f",
"is_draft": false,
"merge_request_id": 42,
"repository_id": "5b0e7c2a-9d14-4e8b-a6f1-2c3d4e5f6a70",
"source_branch": "refactor/brand-inline",
"source_branch_deleted": false,
"source_branch_head": "527e292d275f47c8195d804b968170e4adbe48ae",
"status": "open",
"target_branch": "main",
"target_branch_head": "74c56d90ba2962ada9fd585e7ae35e9e144e168f",
"title": "Pin a page's payload to the build that rendered it",
"updated_at": "2026-10-11T02:10:59Z"
},
{
"created_at": "2026-10-12T06:49:28Z",
"created_by": "b7e2d1c0-9f8e-4d7c-a6b5-c4d3e2f1a0b9",
"is_draft": false,
"merge_request_id": 42,
"repository_id": "5b0e7c2a-9d14-4e8b-a6f1-2c3d4e5f6a70",
"source_branch": "refactor/brand-inline",
"source_branch_deleted": false,
"source_branch_head": "13cd70a83163e9fbbbded721e58aba9999d0e1f6",
"status": "open",
"target_branch": "main",
"target_branch_head": "1a8a76bc9bf4b46f3c255c79cfcaae2d2c206553",
"title": "Draw the region map from operation density",
"updated_at": "2026-10-11T03:35:31Z"
}
],
"next_token": "next-token-f934"
}
Graph
Used inside
No schema contains this one.
Contains
Used by
Sent by 0 operations
No operation takes it as a request body.
Returned by 4 operations
- GETList merge requests across a group's subtree/groups/{group_id}/merge-requests
- GETList merge requests/repositories/{repo_id}/merge-requests
- GETList the merge requests authored by the calling user/user/merge-requests
- GETList the merge requests the calling user is a reviewer of, across all repos/user/review-requests