Retrieve a project label

GET

/api/v4/projects/{id}/labels/{name}

• GitLab REST API

Retrieves a specified label for a project.

Authorizations

• http
• oauth2

Parameters

Path Parameters

id

required

One of:

string

string

integer

integer

The ID or URL-encoded path of the project

name

required

string

The name of a label

Query Parameters

include_ancestor_groups

boolean

default: true nullable

Include ancestor groups

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

priority

integer

is_project_label

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,
  "priority": 10
}

400

Bad Request

404

Not Found