list_merge_requests
Retrieve GitLab merge requests with filtering options to find specific code changes by assignee, author, labels, state, or date ranges.
Instructions
List merge requests in a GitLab project with filtering options
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | Project ID or URL-encoded path | |
| assignee_id | No | Returns merge requests assigned to the given user ID | |
| assignee_username | No | Returns merge requests assigned to the given username | |
| author_id | No | Returns merge requests created by the given user ID | |
| author_username | No | Returns merge requests created by the given username | |
| reviewer_id | No | Returns merge requests which have the user as a reviewer | |
| reviewer_username | No | Returns merge requests which have the user as a reviewer | |
| created_after | No | Return merge requests created after the given time | |
| created_before | No | Return merge requests created before the given time | |
| updated_after | No | Return merge requests updated after the given time | |
| updated_before | No | Return merge requests updated before the given time | |
| labels | No | Array of label names | |
| milestone | No | Milestone title | |
| scope | No | Return merge requests from a specific scope | |
| search | No | Search for specific terms | |
| state | No | Return merge requests with a specific state | |
| order_by | No | Return merge requests ordered by the given field | |
| sort | No | Return merge requests sorted in ascending or descending order | |
| target_branch | No | Return merge requests targeting a specific branch | |
| source_branch | No | Return merge requests from a specific source branch | |
| wip | No | Filter merge requests against their wip status | |
| with_labels_details | No | Return more details for each label | |
| page | No | Page number for pagination (default: 1) | |
| per_page | No | Number of items per page (max: 100, default: 20) |
Input Schema (JSON Schema)
{
"properties": {
"assignee_id": {
"description": "Returns merge requests assigned to the given user ID",
"type": "number"
},
"assignee_username": {
"description": "Returns merge requests assigned to the given username",
"type": "string"
},
"author_id": {
"description": "Returns merge requests created by the given user ID",
"type": "number"
},
"author_username": {
"description": "Returns merge requests created by the given username",
"type": "string"
},
"created_after": {
"description": "Return merge requests created after the given time",
"type": "string"
},
"created_before": {
"description": "Return merge requests created before the given time",
"type": "string"
},
"labels": {
"description": "Array of label names",
"items": {
"type": "string"
},
"type": "array"
},
"milestone": {
"description": "Milestone title",
"type": "string"
},
"order_by": {
"description": "Return merge requests ordered by the given field",
"enum": [
"created_at",
"updated_at",
"priority",
"label_priority",
"milestone_due",
"popularity"
],
"type": "string"
},
"page": {
"description": "Page number for pagination (default: 1)",
"type": "number"
},
"per_page": {
"description": "Number of items per page (max: 100, default: 20)",
"type": "number"
},
"project_id": {
"description": "Project ID or URL-encoded path",
"type": "string"
},
"reviewer_id": {
"description": "Returns merge requests which have the user as a reviewer",
"type": "number"
},
"reviewer_username": {
"description": "Returns merge requests which have the user as a reviewer",
"type": "string"
},
"scope": {
"description": "Return merge requests from a specific scope",
"enum": [
"created_by_me",
"assigned_to_me",
"all"
],
"type": "string"
},
"search": {
"description": "Search for specific terms",
"type": "string"
},
"sort": {
"description": "Return merge requests sorted in ascending or descending order",
"enum": [
"asc",
"desc"
],
"type": "string"
},
"source_branch": {
"description": "Return merge requests from a specific source branch",
"type": "string"
},
"state": {
"description": "Return merge requests with a specific state",
"enum": [
"opened",
"closed",
"locked",
"merged",
"all"
],
"type": "string"
},
"target_branch": {
"description": "Return merge requests targeting a specific branch",
"type": "string"
},
"updated_after": {
"description": "Return merge requests updated after the given time",
"type": "string"
},
"updated_before": {
"description": "Return merge requests updated before the given time",
"type": "string"
},
"wip": {
"description": "Filter merge requests against their wip status",
"enum": [
"yes",
"no"
],
"type": "string"
},
"with_labels_details": {
"description": "Return more details for each label",
"type": "boolean"
}
},
"required": [
"project_id"
],
"type": "object"
}