---
title: "List open channels"
method: GET
path: "/v3/open_channels"
tags: ["Open channel"]
---

# List open channels

`GET /v3/open_channels`

## Request

- Base URL: `https://api-APP_ID.sendbird.com`
- URL: `https://api-APP_ID.sendbird.com/v3/open_channels`
- Auth: none declared

## List open channels

This action retrieves a list of [open channels](https://sendbird.com/docs/chat/platform-api/v3/channel/channel-overview#2-channel-types-3-open-channel). You can use various query parameters to determine the search scope and select what kind of information you want to receive about the queried channels.

[https://sendbird.com/docs/chat/platform-api/v3/channel/listing-channels-in-an-application/list-open-channels#1-list-open-channels](https://sendbird.com/docs/chat/platform-api/v3/channel/listing-channels-in-an-application/list-open-channels#1-list-open-channels)

## Query parameters

- `token` string
- `channel_urls` string
- `limit` integer
- `custom_types` string
- `name_contains` string
- `url_contains` string
- `show_frozen` boolean
- `show_metadata` boolean

## Headers

- `api-token` string

## Response `200`

Successful response

- ListOpenChannelsResponse
  - `channels` SendbirdOpenChannel[]
    - `channel_url` string, required
    - `cover_url` string
    - `created_at` integer
    - `custom_type` string
    - `data` string
    - `freeze` boolean
    - `is_dynamic_partitioned` boolean
    - `is_ephemeral` boolean
    - `max_length_message` integer
    - `name` string
    - `operators` 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
    - `participant_count` integer
    - `metadata` object, nullable
  - `next` string
  - `ts` integer

## Changes

- **2025-10-17** `b05d4e3c6329`: 3 breaking, 1 info
  - the response property `channels/items/metadata` became nullable for the status `200`
  - the response property `channels/items/operators/items/metadata` became nullable for the status `200`
  - the response property `channels/items/operators/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** `7a85bad03e90`: 20 warning, 8 info
  - deleted the `header` request parameter `Api-Token`
  - deleted the `query` request parameter `custom_type`
  - removed the optional property `channels/items/creator` from the response with the `200` status
  - removed the optional property `channels/items/operators/items/access_token` from the response with the `200` status
  - …24 more
- **2024-09-24** `375ce8bc9c64`: 2 breaking
  - the response property `channels/items/creator` became nullable for the status `200`
  - the response property `channels/items/operators/items/` became nullable for the status `200`
- **2024-07-15** `f84d82aae1df`: 1 warning
  - removed the optional property `channels/items/is_frozen` from the response with the `200` status
- **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/open_channels/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)