---
title: "Service: /groups/{group}/members [GET]"
source: https://dev.pageseeder.com/api/services/memberships-GET.html
description: "Memberships"
last_updated: 2026-08-07T17:09:54+10:00
document_type: api_endpoint
operation_id: membership-GET
resource_id: membership
path_template: /groups/{group}/members
http_method: GET
api_category: membership
implementation_version: null
api_since: null
deprecated_since: null
obsolete_since: null
api_support: supported
cache_control: null
generated_at: 2026-08-07
tokens: ~580
---

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

## Description

Collection of members in the group.

Returns the list of members for a group.

## Parameters

| Name | Description | Required | Type | Default |
| --- | --- | --- | --- | --- |
| deleted | If removed/deregistered and invited members should be included in the response (subgroups and permanently deleted not included) | no | boolean | `false` |
| members | A comma-separated list of member `ID`s to return only certain members (overrides usernames) | no | longs |  |
| page | The page to load (only for `subgroups=false`) | no | long | `1` |
| pagesize | The number of results per page (might return less results if `subgroups=true`) | no | long | `1000` |
| subgroups | If subgroups should be included in the response (`false` if members or usernames specified) | no | boolean | `true` |
| usernames | A comma-separated list of member usernames to return only certain members | no | strings |  |

## Permission

This service requires reviewer or higher.

## Response

This service returns a `<memberships>` element containing:

1. The group or project common to all memberships as basic  `<group>` or `<project>`;
2. Each membership as a `<membership>` element including the `<member>` and if applicable, the `<details>` element.

```lang-xml

<memberships count="[n]" [limitreached="true"]>
  <group|project id="[group id]"
                 name="[group name]"
                 description="[description]"
                 owner="[owner]"
                 [relatedurl="[url]"] />
  <membership id="[membership id]"
              email-listed="[true|false]"
              notification="[notification]"
              status="normal"
              role="[role]"
              [subgroups="[subgroups]"]>
    <member id="[member id]"
            firstname="[first name]"
            surname="[surname]"
            username="[username]"
            status="[activated|unactivated]">
      <fullname>[full name]</fullname>
    </member>
  </membership>
  <membership status="invited" ...> ... </membership>
  ...
</memberships> 

```

## Error Handling

| Code | Cause / Description |
| --- | --- |
| 0x1022 | The member does not belong to the group |
| 0x1027 | The supplied member ID is invalid |
| 0x6004 | If the member details have not been configured properly |

 

