# Query the channel list (/en/api-reference/api-ref/rtc/query-channel-list)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

Retrieves channels under a specified project.

- OpenAPI: /openapi/rtc/channel-management.en.yaml
- Operation ID: cma-query-channel-list
- Method: GET
- Path: /dev/v1/channel/{appid}

## Servers

- https://api.agora.io

## Parameters

- `appid` (path, required) - The App ID of the project. You can get it through one of the following methods:
- Copy from the [Agora Console](https://console.agora.io)
- Call the Get all projects API, and read the value of the `vendor_key`
  field in the response body.
- `page_no` (query, optional) - The page number to query. The default value is `0`, which is the first page. The value of `page_no` cannot exceed `(total number of channels / page_size) - 1`; otherwise, the specified page contains no channels.
- `page_size` (query, optional) - The number of channels per page. The value range is [1,500].

## Request body

No request body.

## Responses

### 200

A `200` status code indicates success. The response body contains the result of the request.

- `success` (boolean) - The state of this request:
- `true`: Success.
- `false`: Reserved for future use.
No schema.
- `data` (object) - Channel statistics.
  - `data.channels` (array) - The list of channels. If the specified page contains no channels, this field is empty.

The list of channels. Each object in the array represents one channel and contains the following fields. If the specified page contains no channels, this field is empty.
    - `data.channels.items` (object)
      - `data.channels.items.channel_name` (string) - The channel name.
No schema.
      - `data.channels.items.user_count` (number) - The total number of users in the channel.
No schema.
  - `data.total_size` (number) - The total number of channels under the specified project.
No schema.
### default

The request failed. See the `message` field in the response body for the reason. Refer to Response status codes for details.

No schema.