---
title: "Service: /groups/{group}/members/find [GET]"
source: https://dev.pageseeder.com/api/services/find-group-members_get.html
description: "Searches for members in a group by optional criteria (email, name, role, status, custom fields). Returns matching members with group details. Requires reviewer+ permission; full details shown to managers only."
last_updated: 2026-09-08T11:43:17+10:00
document_type: api_endpoint
operation_id: membership-GET
resource_id: membership
path_template: /groups/{group}/members/find
http_method: GET
api_category: membership
implementation_version: 6.1001
api_since: 4.9500
deprecated_since: null
obsolete_since: null
api_support: supported
cache_control: null
generated_at: 2026-09-02
tokens: ~951
---

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

## Description

This service searches for members in the group that match the specified criteria and returns the group details for a list of group members based on the search parameters.

### Search parameters

The parameters to search members are all optional.

The search performs an exact matching but case insensitive search.

> **Note:** For subgroup memberships the member-role and field\[x\] parameters are ignored and only status `normal` are returned.

## Parameters

| Name | Description | Required | Type | Default |
| --- | --- | --- | --- | --- |
| countonly | If `true`, only return the count of the number of results (ignores `pagesize`) | no | boolean | false |
| email | The member’s email address | no | email |  |
| field1 | Custom field #1 | no | string |  |
| field10 | Custom field #10 | no | string |  |
| field11 | Custom field #11 | no | string |  |
| field12 | Custom field #12 | no | string |  |
| field13 | Custom field #13 | no | string |  |
| field14 | Custom field #14 | no | string |  |
| field15 | Custom field #15 | no  | string |  |
| field2 | Custom field #2 | no | string |  |
| field3 | Custom field #3 | no | string |  |
| field4 | Custom field #4 | no | string |  |
| field5 | Custom field #5 | no | string |  |
| field6 | Custom field #6 | no | string |  |
| field7 | Custom field #7 | no | string |  |
| field8 | Custom field #8 | no | string |  |
| field9 | Custom field #9 | no | string |  |
| firstname | The member’s given/other name | no | string |  |
| member-role | The member’s role, can be: `guest`, `reviewer`, `contributor`, `manager`, `moderator`, `approver`, `moderator-and-approver`(ignored for subgroups) | no | string |  |
| member-username | The member’s username | no  | string |  |
| 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` |
| role | If equal to `manager`, display the full details for each member (group manager only) | no  | string |  |
| status | A comma-separated list of the member’s membership statuses, can be: `normal`, `invited`, `self-invited`, `moderated`, `disabled` | no | string |  |
| subgroups | If subgroups should be included in the response (only status `normal` returned for subgroups) | no | boolean | true |
| surname | The member’s family name | no | string |  |

## Permission

This service requires reviewer or higher.

This service only returns the full member details if the role parameter is specified and set to `manager` and the logged in user has the role of manager in the group.

## Response

```xml

<memberships count="[n]" [limitreached="true"]>
  <group|project id="[group id]"
                 name="[group name]"
                 description="[description]"
                 owner="[owner]"
                 [relatedurl="[url]"] />
  <membership id="[membershipid]"
              email-listed="[true|false]"
              notification="[notification]"
              flags="[flags]"
              [status="status"]
              [role="status"]
              [subgroups="[subgroups]"]>
    <member id="[member id]"
            firstname="[first name]"
            surname="[surname]"
            username="[username]"
            flags="[flags]"
            status="[activated|unactivated]">
      <fullname>[full name]</fullname>
    </member>
   [<details>
      <field position="1" name="tel" editable="true" title="Tel">
        0123 456 789
      </field>
      ...
    </details>]
  </membership>
  ...
</memberships>
```

Custom fields can also be returned, see [Custom member details](../../guide/configuration/custom_member_details.md).

## Error Handling

No specific errors expected for this service.