---
title: "Enumerate all active channels of the application"
method: GET
path: "/channels"
tags: ["Status"]
---

# Enumerate all active channels of the application

`GET /channels`

Enumerate all active channels of the application

## Query parameters

- `limit` integer
- `prefix` string
- `by` 'value' | 'id'

## Response `2XX`

OK

- union
  - ChannelDetails[]
    - `channelId` string, required — The required name of the channel including any qualifier, if any.
    - `region` string — In events relating to the activity of a channel in a specific region, this optionally identifies the region.
    - `isGlobalMaster` boolean — In events relating to the activity of a channel in a specific region, this optionally identifies whether or not that region is responsible for global coordination of the channel.
    - `status` ChannelStatus — A ChannelStatus instance.
      - `isActive` boolean, required — A required boolean value indicating whether the channel that is the subject of the event is active. For events indicating regional activity of a channel this indicates activity in that region, not global activity.
      - `occupancy` Occupancy — An Occupancy instance indicating the occupancy of a channel. For events indicating regional activity of a channel this indicates activity in that region, not global activity.
        - `publishers` integer — The number of connections attached to the channel that are authorised to publish.
        - `subscribers` integer — The number of connections attached that are authorised to subscribe to messages.
        - `presenceSubscribers` integer — The number of connections that are authorised to subscribe to presence messages.
        - `presenceConnections` integer — The number of connections that are authorised to enter members into the presence channel.
        - `presenceMembers` integer — The number of members currently entered into the presence channel.
  - string[]

## Other responses

- `default` — Error

---

[API](https://skmtc.dev/ably/apis/platform-api.md) · [All operations](https://skmtc.dev/ably/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ably/platform-api/revisions/d9cf7e90bb58/schema)