List all project issues
Lists all issues for a specified project. If the project is private, you need to provide credentials to authorize. In most cases, you should authenticate with a personal access token.
Authorizations
Section titled “ Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “ Path Parameters ”Query Parameters
Section titled “ Query Parameters ”Return titles of labels and other details
Return opened, closed, or all issues
Return issues which were closed by the user with the given ID.
Return issues ordered by created_at, due_date, label_priority, milestone_due, popularity, priority, relative_position, title, or updated_at fields.
Return issues sorted in asc or desc order.
Return issues that have no due date (0), or whose due date is this week, this month, between two weeks ago and next month, or which are overdue. Accepts: overdue, week, month, next_month_and_previous_two_weeks, 0
The type of the issue. Accepts: issue, incident, test_case, requirement, task, ticket
Comma-separated list of label names
Milestone title
Return issues assigned to milestones with the specified timebox value (“Any”, “None”, “Upcoming” or “Started”)
The IID array of issues
Search issues for text present in the title, description, or any combination of these
title, description, or a string joining them with comma
Return issues which are authored by the user with the given ID
Return issues which are authored by the user with the given username
Return issues which are assigned to the user with the given username
Return issues created after the specified time
Return issues created before the specified time
Return issues updated after the specified time
Return issues updated before the specified time
Filters by the specified parameters
object
Comma-separated list of label names
Milestone title
Return issues assigned to milestones without the specified timebox value (“Any”, “None”, “Upcoming” or “Started”)
The IID array of issues
Return issues which are not authored by the user with the given ID
Return issues which are not authored by the user with the given username
Return issues which are not assigned to the user with the given ID
Return issues which are not assigned to the user with the given username
Return issues without the specified weight
Return issues which are not assigned to the iteration with the given title
Return issues for the given scope: created_by_me, assigned_to_me or all
Return issues reacted by the authenticated user by the given emoji
Filter confidential or public issues
The health status of the issue. Must be one of: on_track, needs_attention, at_risk, none, any
Return issues which are assigned to the iteration with the given title
Current page number
Example
1Number of items per page
Example
20Cursor for obtaining the next set of records
Responses
Section titled “ Responses ”OK
object
object
object
object
object
object
object
object
One of [“ISSUE”, “INCIDENT”, “TEST_CASE”, “REQUIREMENT”, “TASK”, “TICKET”]
object
object
object
object
object
object
One of [“UNKNOWN”, “LOW”, “MEDIUM”, “HIGH”, “CRITICAL”]
object
object
Example
{ "id": 84, "iid": 14, "project_id": 4, "title": "Impedit et ut et dolores vero provident ullam est", "description": "Repellendus impedit et vel velit dignissimos.", "state": "closed", "created_at": "2022-08-17T12:46:35.053Z", "updated_at": "2022-11-14T17:22:01.470Z", "closed_at": "2022-11-15T08:30:55.232Z", "closed_by": { "id": 1, "username": "admin", "public_email": "john@example.com", "name": "Administrator", "state": "active", "avatar_url": "https://gravatar.com/avatar/1", "avatar_path": "/user/avatar/28/The-Big-Lebowski-400-400.png", "custom_attributes": [ { "key": "foo", "value": "bar" } ], "web_url": "https://gitlab.example.com/root" }, "labels": [ "bug" ], "assignees": { "id": 1, "username": "admin", "public_email": "john@example.com", "name": "Administrator", "state": "active", "avatar_url": "https://gravatar.com/avatar/1", "avatar_path": "/user/avatar/28/The-Big-Lebowski-400-400.png", "custom_attributes": [ { "key": "foo", "value": "bar" } ], "web_url": "https://gitlab.example.com/root" }, "author": { "id": 1, "username": "admin", "public_email": "john@example.com", "name": "Administrator", "state": "active", "avatar_url": "https://gravatar.com/avatar/1", "avatar_path": "/user/avatar/28/The-Big-Lebowski-400-400.png", "custom_attributes": [ { "key": "foo", "value": "bar" } ], "web_url": "https://gitlab.example.com/root" }, "type": "ISSUE", "assignee": { "id": 1, "username": "admin", "public_email": "john@example.com", "name": "Administrator", "state": "active", "avatar_url": "https://gravatar.com/avatar/1", "avatar_path": "/user/avatar/28/The-Big-Lebowski-400-400.png", "custom_attributes": [ { "key": "foo", "value": "bar" } ], "web_url": "https://gitlab.example.com/root" }, "start_date": "2022-11-18", "due_date": "2022-11-20", "issue_type": "issue", "web_url": "http://example.com/example/example/issues/14", "time_stats": { "time_estimate": 12600, "total_time_spent": 3600, "human_time_estimate": "3h 30m", "human_total_time_spent": "1h" }, "task_completion_status": { "count": 5, "completed_count": 3 }, "weight": 5, "blocking_issues_count": 2, "has_tasks": true, "task_status": "2 of 4 tasks completed", "references": { "short": "&6", "relative": "&6", "full": "test&6" }, "subscribed": false, "moved_to_id": 1, "imported": false, "imported_from": "github", "service_desk_reply_to": "user@example.com", "iteration": { "id": 1, "iid": 1, "sequence": 1, "group_id": 1, "title": "Iteration I", "description": "Iteration description", "state": 1, "created_at": "2022-01-31T15:10:45.080Z", "updated_at": "2022-01-31T15:10:45.080Z", "start_date": "2022-01-01", "due_date": "2022-01-31", "web_url": "https://gitlab.example.com/groups/gitlab-org/-/iterations/1" }}Bad Request
Not Found