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

# Get presence of a channel

`GET /channels/{channel_id}/presence`

Get presence on a channel

## Path parameters

- `channel_id` string, required

## Query parameters

- `clientId` string
- `connectionId` string
- `limit` integer

## Response `200`

OK

- PresenceMessage[]
  - `id` string — Unique ID assigned by Ably to this presence update.
  - `action` 'ABSENT' | 'PRESENT' | 'ENTER' | 'LEAVE' | 'UPDATE' — The event signified by a PresenceMessage.
  - `data` string — The presence update payload, if provided.
  - `clientId` string — The client ID of the publisher of this presence update.
  - `connectionId` string — The connection ID of the publisher of this presence update.
  - `timestamp` integer — Timestamp when the presence update was received by Ably, as milliseconds since the epoch.
  - `encoding` string — This will typically be empty as all presence updates received from Ably are automatically decoded client-side using this value. However, if the message encoding cannot be processed, this attribute will contain the remaining transformations not applied to the data payload.
  - `extras` Extras — Extras object. Currently only allows for [push](https://www.ably.io/documentation/general/push/publish#channel-broadcast-example) extra.
    - `push` Push
      - `data` string — Arbitrary [key-value string-to-string payload](https://www.ably.io/documentation/general/push/publish#channel-broadcast-example).
      - `notification` Notification
        - `title` string — Title to display at the notification.
        - `body` string — Text below title on the expanded notification.
        - `icon` string — Platform-specific icon for the notification.
        - `sound` string — Platform-specific sound for the notification.
        - `collapseKey` string — Platform-specific, used to group notifications together.
      - `apns` object — Extends and overrides generic values when delivering via APNs. [See examples](https://www.ably.io/documentation/general/push/publish#payload-structure)
        - `notification` Notification
          - `title` string — Title to display at the notification.
          - `body` string — Text below title on the expanded notification.
          - `icon` string — Platform-specific icon for the notification.
          - `sound` string — Platform-specific sound for the notification.
          - `collapseKey` string — Platform-specific, used to group notifications together.
      - `fcm` object — Extends and overrides generic values when delivering via GCM/FCM. [See examples](https://www.ably.io/documentation/general/push/publish#payload-structure)
        - `notification` Notification
          - `title` string — Title to display at the notification.
          - `body` string — Text below title on the expanded notification.
          - `icon` string — Platform-specific icon for the notification.
          - `sound` string — Platform-specific sound for the notification.
          - `collapseKey` string — Platform-specific, used to group notifications together.
      - `web` object — Extends and overrides generic values when delivering via web. [See examples](https://www.ably.io/documentation/general/push/publish#payload-structure)
        - `notification` Notification
          - `title` string — Title to display at the notification.
          - `body` string — Text below title on the expanded notification.
          - `icon` string — Platform-specific icon for the notification.
          - `sound` string — Platform-specific sound for the notification.
          - `collapseKey` string — Platform-specific, used to group notifications together.

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