--- title: "Get a group channel" method: GET path: "/v3/group_channels/{channel_url}" tags: ["Group channel"] --- # Get a group channel `GET /v3/group_channels/{channel_url}` ## Request - Base URL: `https://api-APP_ID.sendbird.com` - URL: `https://api-APP_ID.sendbird.com/v3/group_channels/{channel_url}` - Auth: none declared ## Get a group channel This action retrieves information about a specific [group channel](https://sendbird.com/docs/chat/platform-api/v3/channel/channel-overview#2-channel-types-3-group-channel). You can use the optional query parameters to determine whether to include delivery receipt, read receipt, or member information in the response. https://sendbird.com/docs/chat/platform-api/v3/channel/listing-channels-in-an-application/get-a-group-channel#1-get-a-group-channel `channel_url` Type: string Description: Specifies the URL of the channel to retrieve. ## Path parameters - `channel_url` string, required ## Query parameters - `show_delivery_receipt` boolean - `show_read_receipt` boolean - `show_member` boolean - `member_active_mode` 'all' | 'activated' | 'deactivated' - `user_id` string ## Headers - `api-token` string ## Response `200` Successful response - GetAGroupChannelResponse - `channel` SendbirdGroupChannelDetailChannel - `channel_url` string - `cover_url` string - `created_at` integer - `custom_type` string - `data` string - `max_length_message` integer - `member_count` integer - `name` string - `channel_url` string, required - `count_preference` 'false' | 'all' | 'unread_message_count_only' | 'unread_mentioned_count_only' - `cover_url` string - `created_at` integer - `created_by` SendbirdBasicUserInfo - `require_auth_for_profile_image` boolean - `is_active` boolean - `is_blocked_by_me` boolean - `role` '' | 'none' | 'operator' - `nickname` string, nullable - `user_id` string, required - `profile_url` string - `metadata` object, nullable - `custom_type` string - `data` string - `delivery_receipt` object - `disappearing_message` SendbirdDisappearingMessage - `message_survival_seconds` integer - `is_triggered_by_message_read` boolean - `freeze` boolean - `has_ai_bot` boolean - `has_bot` boolean - `hidden_state` 'hidden_allow_auto_unhide' | 'hidden_prevent_auto_unhide' | 'unhidden' - `ignore_profanity_filter` boolean - `invited_at` integer - `inviter` SendbirdBasicUserInfo - `require_auth_for_profile_image` boolean - `is_active` boolean - `is_blocked_by_me` boolean - `role` '' | 'none' | 'operator' - `nickname` string, nullable - `user_id` string, required - `profile_url` string - `metadata` object, nullable - `is_access_code_required` boolean, nullable - `is_broadcast` boolean - `is_discoverable` boolean - `is_distinct` boolean - `is_ephemeral` boolean - `is_exclusive` boolean - `is_hidden` boolean - `is_muted` boolean - `is_public` boolean - `is_push_enabled` boolean - `is_super` boolean - `joined_member_count` integer - `joined_ts` integer, nullable - `last_message` SendbirdGroupChannelLastMessage - `require_auth` boolean - `message_survival_seconds` integer - `custom_type` string - `mentioned_users` SendbirdBasicUserInfo[] - `require_auth_for_profile_image` boolean - `is_active` boolean - `is_blocked_by_me` boolean - `role` '' | 'none' | 'operator' - `nickname` string, nullable - `user_id` string, required - `profile_url` string - `metadata` object, nullable - `translations` object - `updated_at` integer - `is_op_msg` boolean - `reactions` SendbirdReaction[] - `key` string - `updated_at` integer - `user_ids` string[] - `is_removed` boolean - `user` SendbirdBasicUserInfo - `require_auth_for_profile_image` boolean - `is_active` boolean - `is_blocked_by_me` boolean - `role` '' | 'none' | 'operator' - `nickname` string, nullable - `user_id` string, required - `profile_url` string - `metadata` object, nullable - `file` object - `files` SendbirdFile[] - `url` string - `file_name` string - `file_size` integer - `file_type` string - `thumbnails` SendbirdThumbnail[] - `height` integer - `plain_url` string - `real_height` integer - `real_width` integer - `url` string - `width` integer - `require_auth` boolean - `message` string - `data` string - `message_retention_hour` integer - `silent` boolean - `type` string - `created_at` integer - `channel_type` string - `req_id` string - `mention_type` string - `channel_url` string - `message_id` integer - `sorted_metaarray` SendbirdSortedMetaarrayInner[] - `key` string - `value` string[] - `thread_info` object - `parent_message_id` integer - `parent_message_info` SendbirdParentMessageInfo - `custom_type` string - `message` string - `type` string - `ts` integer - `user` SendbirdUser: User - `access_token` string - `created_at` integer - `discovery_keys` string[], nullable - `has_ever_logged_in` boolean - `is_active` boolean - `is_hide_me_from_friends` boolean - `is_online` boolean - `is_shadow_blocked` boolean - `last_seen_at` integer - `locale` string - `metadata` object, nullable - `nickname` string, nullable - `preferred_languages` string[], nullable - `profile_url` string - `require_auth_for_profile_image` boolean - `user_id` string, required - `state` '' | 'invited' | 'joined', nullable - `unread_channel_count` integer - `unread_message_count` integer - `phone_number` string - `is_created` boolean - `file` SendbirdFile - `url` string - `file_name` string - `file_size` integer - `file_type` string - `thumbnails` SendbirdThumbnail[] - `height` integer - `plain_url` string - `real_height` integer - `real_width` integer - `url` string - `width` integer - `require_auth` boolean - `files` SendbirdFile[] - `url` string - `file_name` string - `file_size` integer - `file_type` string - `thumbnails` SendbirdThumbnail[] - `height` integer - `plain_url` string - `real_height` integer - `real_width` integer - `url` string - `width` integer - `require_auth` boolean - `is_reply_to_channel` boolean - `message_events` SendbirdMessageResponseMessageEvents, nullable - `send_push_notification` string - `update_unread_count` boolean - `update_mention_count` boolean - `update_last_message` boolean - `extended_message_payload` SendbirdMessageResponseExtendedMessagePayload: Specifies the extended message payload which is used to send a message with a custom message type. - `custom_view` object: JSON format you want to embed in message, eq : {"title": "title", "image": "https://link.to/image.jpg"} - `suggested_replies` string[]: Specifies an array of suggested replies to be sent with the message. - `max_length_message` integer - `member_count` integer - `member_state` 'invited' | 'joined' | 'none' - `members` SendbirdMember[] - `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 - `message_survival_seconds` integer - `metadata` object, nullable - `my_role` '' | 'none' | 'operator' - `name` string - `push_trigger_option` 'all' | 'mention_only' | 'off' - `read_receipt` object - `sms_fallback` SendbirdSmsFallback - `wait_seconds` integer - `exclude_user_ids` string[] - `ts_message_offset` integer - `unread_mention_count` integer - `unread_message_count` integer - `user_last_read` integer ## Changes - **2025-10-17** `2a35c3c56c0f`: 2 info - added `#/components/schemas/SendbirdGroupChannel` to the response body `allOf` list for the response status `200` - removed `#/components/schemas/Sendbird.GroupChannel` from the response body `allOf` list for the response status `200` - **2025-10-17** `b05d4e3c6329`: 2 info - added `#/components/schemas/Sendbird.GroupChannel` to the response body `allOf` list for the response status `200` - removed `#/components/schemas/SendBird.GroupChannel` from the response body `allOf` list for the response status `200` - **2025-10-17** `716caef6594d`: 2 info - added `#/components/schemas/SendBird.GroupChannel` to the response body `allOf` list for the response status `200` - removed `#/components/schemas/Sendbird.GroupChannel` from the response body `allOf` list for the response status `200` - **2025-10-17** `b05d4e3c6329`: 11 breaking, 30 warning, 3 info - the response property `allOf[#/components/schemas/Sendbird.GroupChannel]/created_by/metadata` became nullable for the status `200` - the response property `allOf[#/components/schemas/Sendbird.GroupChannel]/created_by/nickname` became nullable for the status `200` - the response property `allOf[#/components/schemas/Sendbird.GroupChannel]/inviter/metadata` became nullable for the status `200` - the response property `allOf[#/components/schemas/Sendbird.GroupChannel]/inviter/nickname` became nullable for the status `200` - …40 more - …earlier changes not shown [Operation history](https://skmtc.dev/sendbird/apis/sendbird-platform-sdk/changes/v3/group_channels/:channel_url/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)