---
title: "Service: /groups/{group}/subgroups [GET]"
source: https://dev.pageseeder.com/api/services/list-subgroups-GET.html
description: "GET service that returns a list of subgroups within a specified group. Requires reviewer permission or higher. Returns XML with subgroup elements containing role, notification, and listing attributes."
last_updated: 2026-09-02T11:36:10+10:00
document_type: api_endpoint
operation_id: group-GET
resource_id: group
path_template: /groups/{group}/subgroups
http_method: GET
api_category: group
implementation_version: 6.2004
api_since: 5.4903
deprecated_since: null
obsolete_since: null
api_support: supported
cache_control: null
generated_at: 2026-09-02
tokens: ~241
---

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

## Description

Returns the list of [subgroups](../../reference/glossary/subgroup.md) in the specified [Group](../../reference/glossary/group.md).

## Parameters

No parameters required.

## Permission

This service requires reviewer or higher.

## Response

The XML returns each subgroup in the main group as `<subgroup>` element wrapped in a `<subgroups>` element.

```xml

<subgroups>
  <subgroup id="[id]"
            role="[approver|
                   manager|
                   contributor|
                   reviewer|
                   guest|
                   inherit]"
            notification="[immediate|
                           daily|
                           none|
                           inherit]"
            listed="[true|false|inherit]">
    <group id="[group id]" name="[group name] ..."/>
  </subgroup>
  ...
</subgroups>
```

## Error Handling

No specific errors expected for this service.