List all group labels

GET

/api/v4/groups/{id}/labels

• GitLab REST API

Lists all group labels for a specified group.

Authorizations

• http
• oauth2

Parameters

Path Parameters

id

required

string

The ID of a group

Query Parameters

with_counts

boolean

nullable

Include issue and merge request counts

include_ancestor_groups

boolean

default: true nullable

Include ancestor groups

include_descendant_groups

boolean

nullable

Include descendant groups. This feature was added in GitLab 13.6

only_group_labels

boolean

default: true nullable

Toggle to include only group labels or also project labels. This feature was added in GitLab 13.6

search

string

nullable

Keyword to filter labels by. This feature was added in GitLab 13.6

archived

boolean

nullable

Filter by archived status. This feature was added in GitLab 18.10

page

integer

default: 1 nullable

Current page number

Example

1

per_page

integer

default: 20 nullable

Number of items per page

Example

20

Responses

200

OK

Media type application/json

object

id

integer format: int64

name

string

description

string

text_color

string

description_html

string

color

string

archived

boolean

open_issues_count

integer

closed_issues_count

integer

open_merge_requests_count

integer

subscribed

boolean

Example

{
  "id": 1,
  "name": "bug",
  "description": "Bug reported by user",
  "text_color": "#FFFFFF",
  "description_html": "<p>Bug reported by user</p>",
  "color": "#FF0000",
  "archived": false,
  "open_issues_count": 1,
  "closed_issues_count": 0,
  "open_merge_requests_count": 1,
  "subscribed": false
}

400

Bad Request

404

Not Found