Get a ring group
GET
/v1/voice/ring-groups/{ring_group_id}const group = await bird.voice.ringGroups.get("RING_GROUP_ID");
console.log(group.id, group.name, group.online_member_count);group = client.voice.ring_groups.get("RING_GROUP_ID")
print(group.id, group.name, group.online_member_count)group, err := client.Voice.RingGroups.Get(context.Background(), "RING_GROUP_ID")
if err != nil {
log.Fatal(err)
}
fmt.Println(group.Id, group.Name, group.OnlineMemberCount)$group = $bird->voice->ringGroups->get('RING_GROUP_ID');
echo $group->getId(), ' ', $group->getName(), ' ', $group->getOnlineMemberCount(), "\n";bird voice ring-groups get <ring-group-id>curl -X GET "https://us1.platform.bird.com/v1/voice/ring-groups/{ring_group_id}" \
-H "Authorization: Bearer $TOKEN"响应200
{
"id": "vrg_01krdgeqcxet5s7t44vh8rt9mg",
"name": "Support",
"is_default": false,
"online_member_count": 3,
"created_at": "2026-10-01T12:00:00Z",
"updated_at": "2026-10-01T12:00:00Z"
}
Returns one ring group. The default group's ID is vrg_ followed by the
workspace ID's suffix.
参数
ring_group_idstringID of the ring group.
响应载荷
idstring
必填
Unique identifier for this ring group. The default group's ID is vrg_ followed by the workspace ID's suffix.
namestring
必填
The ring group's name.
is_defaultboolean
必填
Whether this is the workspace's default group, which rings the users who are online in the browser phone.
online_member_countinteger
必填
How many of the group's members are connected to the browser phone and accepting calls, read live. A member on a call counts, though a call to the group skips them until it ends. For the default group, the count includes every connected user who accepts calls.
created_atnullable string
必填
When the ring group was created. Null for the default group.
updated_atnullable string
必填
When the ring group's name or members last changed. Null for the default group.