---
title: "List all issues for the currently authenticated user"
method: GET
path: "/api/v4/issues"
tags: ["issues"]
---

# List all issues for the currently authenticated user

`GET /api/v4/issues`

## Request

- Base URL: `https://gitlab.com`
- URL: `https://gitlab.com/api/v4/issues`
- Auth: none declared

Lists all issues accessible by the currently authenticated user. By default, returns only issues created by the current user. To list all issues, use parameter `scope=all`.

## Query parameters

- `with_labels_details` boolean
- `state` 'opened' | 'closed' | 'all'
- `closed_by_id` integer
- `order_by` 'created_at' | 'due_date' | 'label_priority' | 'milestone_due' | 'popularity' | 'priority' | 'relative_position' | 'title' | 'updated_at' | 'weight'
- `sort` 'asc' | 'desc'
- `due_date` '0' | 'any' | 'today' | 'tomorrow' | 'overdue' | 'week' | 'month' | 'next_month_and_previous_two_weeks' | ''
- `issue_type` 'issue' | 'incident' | 'test_case' | 'requirement' | 'task' | 'ticket'
- `labels` string[]
- `milestone` string
- `milestone_id` 'Any' | 'None' | 'Upcoming' | 'Started'
- `iids` integer[]
- `search` string
- `in` string
- `author_id` integer
- `author_username` string
- `assignee_id` integer
- `assignee_username` string[]
- `created_after` string, date-time
- `created_before` string, date-time
- `updated_after` string, date-time
- `updated_before` string, date-time
- `not[labels]` string[]
- `not[milestone]` string
- `not[milestone_id]` 'Any' | 'None' | 'Upcoming' | 'Started'
- `not[iids]` integer[]
- `not[author_id]` integer
- `not[author_username]` string
- `not[assignee_id]` integer
- `not[assignee_username]` string[]
- `not[weight]` integer
- `not[iteration_id]` integer
- `not[iteration_title]` string
- `scope` 'created-by-me' | 'assigned-to-me' | 'created_by_me' | 'assigned_to_me' | 'all'
- `my_reaction_emoji` string
- `confidential` boolean
- `weight` integer
- `epic_id` integer
- `health_status` 'on_track' | 'needs_attention' | 'at_risk' | 'none' | 'any'
- `iteration_id` integer
- `iteration_title` string
- `page` integer
- `per_page` integer
- `non_archived` boolean

## Response `200`

List all issues for the currently authenticated user

- APIEntitiesIssue: API_Entities_Issue model
  - `id` integer, required
  - `iid` integer, required
  - `project_id` integer, required
  - `title` string, required
  - `description` string, required
  - `state` string, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `closed_at` string, date-time, required
  - `closed_by` APIEntitiesUserBasic, required: API_Entities_UserBasic model
    - `id` integer, required
    - `username` string, required
    - `public_email` string, required
    - `name` string, required
    - `state` string, required
    - `locked` boolean, required
    - `avatar_url` string, required
    - `avatar_path` string
    - `custom_attributes` APIEntitiesCustomAttribute[]
      - `key` string, required
      - `value` string, required
    - `web_url` string, required
  - `labels` string[], required
  - `milestone` APIEntitiesMilestone, required
    - `id` integer, required
    - `iid` integer, required
    - `project_id` integer
    - `group_id` string
    - `title` string, required
    - `description` string, required
    - `state` string, required
    - `created_at` string, required
    - `updated_at` string, required
    - `due_date` string, required
    - `start_date` string, required
    - `expired` boolean, required
    - `web_url` string, required
  - `assignees` APIEntitiesUserBasic, required: API_Entities_UserBasic model
    - `id` integer, required
    - `username` string, required
    - `public_email` string, required
    - `name` string, required
    - `state` string, required
    - `locked` boolean, required
    - `avatar_url` string, required
    - `avatar_path` string
    - `custom_attributes` APIEntitiesCustomAttribute[]
      - `key` string, required
      - `value` string, required
    - `web_url` string, required
  - `author` APIEntitiesUserBasic, required: API_Entities_UserBasic model
    - `id` integer, required
    - `username` string, required
    - `public_email` string, required
    - `name` string, required
    - `state` string, required
    - `locked` boolean, required
    - `avatar_url` string, required
    - `avatar_path` string
    - `custom_attributes` APIEntitiesCustomAttribute[]
      - `key` string, required
      - `value` string, required
    - `web_url` string, required
  - `type` string, required: One of ["ISSUE", "INCIDENT", "TEST_CASE", "REQUIREMENT", "TASK", "TICKET"]
  - `assignee` APIEntitiesUserBasic, required: API_Entities_UserBasic model
    - `id` integer, required
    - `username` string, required
    - `public_email` string, required
    - `name` string, required
    - `state` string, required
    - `locked` boolean, required
    - `avatar_url` string, required
    - `avatar_path` string
    - `custom_attributes` APIEntitiesCustomAttribute[]
      - `key` string, required
      - `value` string, required
    - `web_url` string, required
  - `user_notes_count` integer, required
  - `merge_requests_count` integer, required
  - `upvotes` integer, required
  - `downvotes` integer, required
  - `start_date` string, date, required
  - `due_date` string, date, required
  - `confidential` boolean, required
  - `discussion_locked` boolean, required
  - `issue_type` string, required
  - `web_url` string, required
  - `time_stats` APIEntitiesIssuableTimeStats, required: API_Entities_IssuableTimeStats model
    - `time_estimate` integer, required
    - `total_time_spent` integer, required
    - `human_time_estimate` string, required
    - `human_total_time_spent` string, required
  - `task_completion_status` APIEntitiesTaskCompletionStatus, required
    - `count` integer, required
    - `completed_count` integer, required
  - `weight` integer
  - `blocking_issues_count` integer, required
  - `has_tasks` boolean, required
  - `task_status` string
  - `_links` object, required
    - `self` string, required
    - `notes` string, required
    - `award_emoji` string, required
    - `project` string, required
    - `closed_as_duplicate_of` string, required
  - `references` APIEntitiesIssuableReferences, required
    - `short` string, required
    - `relative` string, required
    - `full` string, required
  - `severity` string, required: One of ["UNKNOWN", "LOW", "MEDIUM", "HIGH", "CRITICAL"]
  - `subscribed` boolean
  - `moved_to_id` integer, required
  - `imported` boolean, required
  - `imported_from` string, required
  - `service_desk_reply_to` string, required
  - `epic_iid` string
  - `epic` EpicBaseEntity
    - `id` string, required
    - `iid` string, required
    - `title` string, required
    - `url` string, required
    - `group_id` string, required
    - `human_readable_end_date` string
    - `human_readable_timestamp` string
  - `iteration` APIEntitiesIteration
    - `id` integer, required
    - `iid` integer, required
    - `sequence` integer, required
    - `group_id` integer, required
    - `title` string, required
    - `description` string, required
    - `state` integer, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `start_date` string, date, required
    - `due_date` string, date, required
    - `web_url` string, required
  - `health_status` string

---

[API](https://skmtc.dev/gitlab/apis/gitlab-api.md) - [All operations](https://skmtc.dev/gitlab/apis/gitlab-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gitlab/apis/gitlab-api/revisions/b234947ef3f2?raw)