---
title: "Service: /groups/{group}/labels [GET]"
source: https://dev.pageseeder.com/api/services/list-labels_get.html
description: "Retrieves the list of labels configured for a group, with optional filtering by label types such as comments, fragments, versions, uploads, and documents. Returns XML with label names and descriptions."
last_updated: 2026-09-08T11:44:53+10:00
document_type: api_endpoint
operation_id: label-GET
resource_id: label
path_template: /groups/{group}/labels
http_method: GET
api_category: label
implementation_version: 6.2004
api_since: 4.6212
deprecated_since: null
obsolete_since: null
api_support: experimental
cache_control: null
generated_at: 2026-09-02
tokens: ~327
---

# /groups/\{group\}/labels \[GET\]

## Description

Returns the list of [labels](../../reference/glossary/labels.md) in a [group](../../reference/glossary/group.md).

## Parameters

| Name | Description | Required | Type | Default value |
| --- | --- | --- | --- | --- |
| types | Comma-separated list of label types to return | no | string |  |

The label type can be any combination of:

- comment
- fragment
- edit-note
- version
- creation
- upload
- document
- xref
- content-inline
- ​content-block

## Permission

This service requires guest unless the group is accessible to public.

## Response

The output has the following format:

```xml

<label-config scope="[server|project|document]"
              template="[project]"
              updated="[updated date time]"> 
  <labels type="[comment|
                 fragment|
                 edit-note|
                 version|
                 creation|
                 upload|
                 document|
                 xref|
                 content-inline|
                 content-block]"> 
    <label name="[label name]" description="[label description]"/>
    <label name="[label name]" description="[label description]"/>
    ...
  </labels> 
  ... 
</label-config>
```

## Error Handling

No specific errors expected for this service.