Retrieve issues statistics for the currently authenticated user

GET

/api/v4/issues_statistics

• GitLab REST API

Retrieves statistics for issues accessible by the currently authenticated user. By default, returns only issues created by the current user. To get all issues, set the scope attribute to all.

Authorizations

• http
• oauth2

Parameters

Query Parameters

labels

Array<string>

nullable

Comma-separated list of label names

milestone

string

nullable

Milestone title

milestone_id

string

nullable

Allowed values: Any None Upcoming Started

Return issues assigned to milestones with the specified timebox value (“Any”, “None”, “Upcoming” or “Started”)

iids

Array<integer>

nullable

The IID array of issues

search

string

nullable

Search issues for text present in the title, description, or any combination of these

in

string

nullable

title, description, or a string joining them with comma

author_id

integer

nullable

Return issues which are authored by the user with the given ID

author_username

string

nullable

Return issues which are authored by the user with the given username

assignee_id

One of:

integer

integer

nullable

string

string

nullable

Return issues which are assigned to the user with the given ID

assignee_username

Array<string>

nullable

Return issues which are assigned to the user with the given username

created_after

string format: date-time

nullable

Return issues created after the specified time

created_before

string format: date-time

nullable

Return issues created before the specified time

updated_after

string format: date-time

nullable

Return issues updated after the specified time

updated_before

string format: date-time

nullable

Return issues updated before the specified time

not

Filters by the specified parameters

object

not[labels]

Array<string>

nullable

Comma-separated list of label names

not[milestone]

string

nullable

Milestone title

not[milestone_id]

string

nullable

Allowed values: Any None Upcoming Started

Return issues assigned to milestones without the specified timebox value (“Any”, “None”, “Upcoming” or “Started”)

not[iids]

Array<integer>

nullable

The IID array of issues

not[author_id]

integer

nullable

Return issues which are not authored by the user with the given ID

not[author_username]

string

nullable

Return issues which are not authored by the user with the given username

not[assignee_id]

integer

nullable

Return issues which are not assigned to the user with the given ID

not[assignee_username]

Array<string>

nullable

Return issues which are not assigned to the user with the given username

not[weight]

integer

nullable

Return issues without the specified weight

not[iteration_id]

One of:

integer

integer

nullable

string

string

nullable

Return issues which are not assigned to the iteration with the given ID

not[iteration_title]

string

nullable

Return issues which are not assigned to the iteration with the given title

scope

string

default: created_by_me nullable

Allowed values: created_by_me assigned_to_me all

Return issues for the given scope: created_by_me, assigned_to_me or all

my_reaction_emoji

string

nullable

Return issues reacted by the authenticated user by the given emoji

confidential

boolean

nullable

Filter confidential or public issues

weight

One of:

integer

integer

nullable

string

string

nullable

The weight of the issue

epic_id

One of:

integer

integer

nullable

string

string

nullable

The ID of an epic associated with the issues

health_status

string

nullable

Allowed values: on_track needs_attention at_risk none any

The health status of the issue. Must be one of: on_track, needs_attention, at_risk, none, any

iteration_id

One of:

integer

integer

nullable

string

string

nullable

Return issues which are assigned to the iteration with the given ID

iteration_title

string

nullable

Return issues which are assigned to the iteration with the given title

Responses

200

OK

400

Bad Request