Get a Realtime channel
GET
/v1/realtime/apps/{realtime_app_id}/channels/{channel_name}
curl -X GET "https://us1.platform.bird.com/v1/realtime/apps/{realtime_app_id}/channels/{channel_name}" \
-H "Authorization: Bearer $TOKEN"Returns a single channel's occupancy and (on request) counts. Channels exist implicitly — a channel appears when the first connection subscribes and vanishes when the last one leaves — so this endpoint reports state, not existence: an unknown or never-used name returns 200 with occupied: false, never 404.
Parameter Kueri
include
array
Attributes to include. Repeatable. Requesting member_count for a non-presence channel, or connection_count when the app's connection-counting flag is off, returns a validation error (400).
Payload Respons
member_count
integer
Distinct members (presence channels only; requires include=member_count).
connection_count
integer
Connections currently subscribed to this channel (requires include=connection_count and the app's connection-counting flag). Channel-scoped — distinct from the app-wide peak connections metric.
occupied
boolean
wajib
Whether at least one client is subscribed.