# `list_group_members`

Read a page of a group’s current members. Reading changes nothing and starts no search.

Annotations: `readOnlyHint: true` · `destructiveHint: false` · `idempotentHint: true` · `openWorldHint: false`

## Inputs

| Field | Required | Type | Meaning |
| --- | --- | --- | --- |
| `groupPublicId` | yes | string | Exact group public ID: 32 lowercase hexadecimal characters, from `list_groups` or an authorized retained reference. |
| `pageSize` | no | integer | Default 20 (also for 0), capped at 100. Negative or fractional values are invalid. |
| `pageToken` | no | string | Omit or use an empty string to start. For continuation, pass the preceding `nextPageToken` unchanged. |

## Result

Each member has `memberId`, nullable `displayName` and `email` from the authorized group roster, `role`, `isCurrentMember`, `isSearchable`, membership `joinedAt`, and nullable `sharedProfile` (`headline`, `location`, `linkedInUrl`). The shared profile follows the member card visibility rule: hidden profiles are absent; inferred Gmail/member profiles require member confirmation, while public LinkedIn profiles may be visible without confirmation. These are the same membership summaries as `get_group.memberPreview`. Order is display name (email when unnamed, empty when neither is available), then member ID. Searchability is eligibility to search a network; it establishes neither suitability nor willingness. No contacts, private relationship context, photos, Gmail state, or connection controls are returned. Missing or inaccessible groups return `unavailable`.

## Continuation

`nextPageToken` is always present. Only an empty string means the list is complete. Continue even if a page is short or empty when its token is nonempty. Tokens expire after one hour and are bound to this operation, authenticated member, and group where applicable. Keep all arguments other than `pageSize` unchanged. Invalid, expired, or mismatched tokens return `invalid_argument`; restart without a token. Each page rechecks current membership. These are live reads, not a snapshot across pages. Within a tool budget, report partial coverage truthfully rather than claiming completion.

## Example

```json list_group_members
{
  "groupPublicId": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "pageSize": 20
}
```

```json result:list_group_members
{
  "members": [
    {
      "memberId": "00000000-0000-4000-a000-000000000003",
      "displayName": "Synthetic member",
      "email": "member@example.test",
      "role": "member",
      "isCurrentMember": true,
      "isSearchable": true,
      "joinedAt": "2026-10-09T00:00:00.000Z",
      "sharedProfile": {
        "headline": "Builds synthetic products",
        "location": null,
        "linkedInUrl": null
      }
    },
    {
      "memberId": "00000000-0000-4000-a000-000000000004",
      "displayName": "Synthetic colleague",
      "email": null,
      "role": "member",
      "isCurrentMember": false,
      "isSearchable": true,
      "joinedAt": "2026-10-09T00:00:00.000Z",
      "sharedProfile": {
        "headline": "Builds synthetic products",
        "location": null,
        "linkedInUrl": null
      }
    }
  ],
  "nextPageToken": ""
}
```
