---
title: "List members"
method: GET
path: "/v3/group_channels/{channel_url}/members"
tags: ["Group channel"]
---

# List members

`GET /v3/group_channels/{channel_url}/members`

## Request

- Base URL: `https://api-APP_ID.sendbird.com`
- URL: `https://api-APP_ID.sendbird.com/v3/group_channels/{channel_url}/members`
- Auth: none declared

## List members

Retrieves a list of members of a group channel.

> **Note**: See [this page](https://sendbird.com/docs/chat/platform-api/v3/channel/channel-overview#2-channel-types-3-open-channel-vs-group-channel-vs-supergroup-channel) to learn more about channel types. 
  

[https://sendbird.com/docs/chat/platform-api/v3/channel/listing-users/list-members-of-a-group-channel#1-list-members-of-a-group-channel](https://sendbird.com/docs/chat/platform-api/v3/channel/listing-users/list-members-of-a-group-channel#1-list-members-of-a-group-channel)

`channel_url`  
Type: string  
Description: Specifies the URL of the channel to retrieve a list of members of.

## Path parameters

- `channel_url` string, required

## Query parameters

- `token` string
- `limit` integer
- `user_id` string
- `show_delivery_receipt` boolean
- `show_read_receipt` boolean
- `show_member_is_muted` boolean
- `order` 'member_nickname_alphabetical' | 'operator_then_member_alphabetical'
- `operator_filter` 'all' | 'operator' | 'nonoperator'
- `member_state_filter` 'all' | 'invited_only' | 'joined_only' | 'invited_by_friend' | 'invited_by_non_friend'
- `muted_member_filter` 'all' | 'muted' | 'unmuted'
- `member_active_mode_filter` 'activated' | 'deactivated'
- `nickname_startswith` string
- `include_push_preference` boolean

## Headers

- `api-token` string

## Response `200`

Successful response

- GroupChannelListMembersResponse
  - `members` SendbirdMember[], required
    - `delivered_ts` integer
    - `do_not_disturb` boolean
    - `friend_discovery_key` string[], nullable
    - `friend_name` string, nullable
    - `is_active` boolean
    - `is_blocked_by_me` boolean
    - `is_blocking_me` boolean
    - `is_muted` boolean
    - `is_online` boolean
    - `last_seen_at` integer
    - `metadata` object, nullable
    - `muted_description` string
    - `muted_end_at` integer
    - `nickname` string, nullable
    - `push_enabled` boolean
    - `push_trigger_option` 'all' | 'mention_only' | 'off'
    - `profile_url` string
    - `require_auth_for_profile_image` boolean
    - `read_ts` integer
    - `role` '' | 'none' | 'operator', nullable
    - `state` '' | 'invited' | 'joined', nullable
    - `user_id` string, required
  - `next` string

## Changes

- **2025-10-17** `b05d4e3c6329`: 2 breaking, 1 info
  - the response property `members/items/metadata` became nullable for the status `200`
  - the response property `members/items/nickname` became nullable for the status `200`
  - the `profile_url` response's property default value `` was added for the status `200`
- **2025-07-27** `073cffd0bd87`: 1 info
  - removed the `default` enum value from the `members/items/push_trigger_option` response property for the response status `200`
- **2025-07-27** `7a85bad03e90`: 4 breaking, 16 warning, 35 info
  - the `query` request parameter `member_state_filter` was restricted to a list of enum values
  - the `query` request parameter `muted_member_filter` was restricted to a list of enum values
  - the `query` request parameter `operator_filter` was restricted to a list of enum values
  - the `query` request parameter `order` was restricted to a list of enum values
  - …51 more
- **2024-09-24** `375ce8bc9c64`: 1 breaking
  - the response property `members/items/` became nullable for the status `200`
- **2023-11-10** `135d8b0705d4`: 1 info
  - the `header` request parameter `Api-Token` became optional

[Operation history](https://skmtc.dev/sendbird/apis/sendbird-platform-sdk/changes/v3/group_channels/:channel_url/members/get.md)

---

[API](https://skmtc.dev/sendbird/apis/sendbird-platform-sdk.md) - [All operations](https://skmtc.dev/sendbird/apis/sendbird-platform-sdk/llms.txt) - [OpenAPI document](https://skmtc.dev/sendbird/apis/sendbird-platform-sdk/revisions/9e53a5288df0?raw)