---
title: "Get label information"
method: GET
path: "/wiki/rest/api/label"
tags: ["Label info"]
---

# Get label information

`GET /wiki/rest/api/label`

Returns label information and a list of contents associated with the label.

**[Permissions](https://confluence.atlassian.com/x/_AozKw) required**:
Permission to access the Confluence site ('Can use' global permission). Only contents
that the user is permitted to view is returned.

## Query parameters

- `name` string, required
- `type` 'page' | 'blogpost' | 'attachment' | 'page_template'
- `start` integer
- `limit` integer

## Response `200`

Returned if the query fetches zero or more results.

- LabelDetails
  - `label` Label, required
    - `prefix` string, required
    - `name` string, required
    - `id` string, required
    - `label` string, required
  - `associatedContents` LabeledContentPageResponse
    - `results` LabeledContent[], required
      - `contentType` 'page' | 'blogpost' | 'attachment' | 'page_template', required
      - `contentId` integer, required
      - `title` string, required — Title of the content.
    - `start` integer
    - `limit` integer
    - `size` integer, required

## Other responses

- `400` — Returned if no label name is provide or if content type provided in the query is invalid.
- `403` — Returned if the calling user does not have permission to view any content including label info.
- `404` — Returned if the lable name is invalid or if no label is found for a given label.

---

[API](https://skmtc.net/atlassian/apis/the-confluence-cloud-rest-api.md) · [All operations](https://skmtc.net/atlassian/apis/the-confluence-cloud-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/the-confluence-cloud-rest-api/revisions/70088490f406/schema)