2022-10-17 17:46:38 +00:00
---
stage: Create
group: Code Review
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/product/ux/technical-writing/#assignments
---
2020-10-26 12:55:03 +00:00
2022-10-19 14:32:40 +00:00
<!--
2022-10-17 17:46:38 +00:00
This documentation is auto generated by a script.
2023-02-07 08:22:45 +00:00
Please do not edit this file directly. Run `make gen-docs` instead.
2022-10-19 14:32:40 +00:00
-->
2020-10-26 12:55:03 +00:00
2022-10-21 14:38:48 +00:00
# `glab mr list`
2020-10-26 12:55:03 +00:00
List merge requests
2022-10-17 17:46:38 +00:00
```plaintext
glab mr list [flags]
```
2020-10-26 12:55:03 +00:00
2023-04-04 01:33:12 +00:00
## Aliases
```plaintext
ls
```
2022-10-17 17:46:38 +00:00
## Examples
2021-01-27 03:51:25 +00:00
2022-10-17 17:46:38 +00:00
```plaintext
2022-10-21 14:38:48 +00:00
glab mr list --all
glab mr ls -a
glab mr list --assignee=@me
glab mr list --reviewer=@me
glab mr list --source-branch=new-feature
glab mr list --target-branch=main
glab mr list --search "this adds feature X"
glab mr list --label needs-review
glab mr list --not-label waiting-maintainer-feedback,subsystem-x
glab mr list -M --per-page 10
2021-01-27 03:51:25 +00:00
2022-10-17 17:46:38 +00:00
```
2022-05-05 18:08:49 +00:00
2022-10-21 14:38:48 +00:00
## Options
2021-01-27 03:51:25 +00:00
2022-10-17 17:46:38 +00:00
```plaintext
2021-01-27 03:51:25 +00:00
-A, --all Get all merge requests
-a, --assignee strings Get only merge requests assigned to users
2022-10-06 20:17:13 +00:00
--author string Filter merge request by Author < username >
2021-01-27 03:51:25 +00:00
-c, --closed Get only closed merge requests
-d, --draft Filter by draft merge requests
2022-12-12 21:56:04 +00:00
-g, --group string Select a group/subgroup. This option is ignored if a repo argument is set.
2021-01-27 03:51:25 +00:00
-l, --label strings Filter merge request by label < name >
-M, --merged Get only merged merge requests
-m, --milestone string Filter merge request by milestone < id >
--not-label strings Filter merge requests by not having label < name >
2024-03-07 06:08:07 +00:00
-F, --output string Format output as: text, json (default "text")
2021-01-27 03:51:25 +00:00
-p, --page int Page number (default 1)
-P, --per-page int Number of items to list per page (default 30)
2023-05-02 14:53:07 +00:00
-R, --repo OWNER/REPO Select another repository using the OWNER/REPO or `GROUP/NAMESPACE/REPO` format or full URL or git URL
2021-05-14 14:33:37 +00:00
-r, --reviewer strings Get only merge requests with users as reviewer
2021-01-27 03:51:25 +00:00
--search string Filter by < string > in title and description
-s, --source-branch string Filter by source branch < name >
-t, --target-branch string Filter by target branch < name >
2022-10-17 17:46:38 +00:00
```
2020-10-26 12:55:03 +00:00
2022-10-21 14:38:48 +00:00
## Options inherited from parent commands
2020-10-26 12:55:03 +00:00
2022-10-17 17:46:38 +00:00
```plaintext
2023-05-02 14:53:07 +00:00
--help Show help for command
2022-10-17 17:46:38 +00:00
```