---
title: "Get metadata of a channel"
method: GET
path: "/channels/{channel_id}"
tags: ["Status"]
---

# Get metadata of a channel

`GET /channels/{channel_id}`

Get metadata of a channel

## Path parameters

- `channel_id` string, required

## Response `200`

OK

- 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.

## 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)