List a ring group's members

GET

/v1/voice/ring-groups/{ring_group_id}/members

const members = await bird.voice.ringGroups.members.list("RING_GROUP_ID");
for (const member of members.data) {
  console.log(member.user_id);
}

members = client.voice.ring_groups.members.list("RING_GROUP_ID")
for member in members.data:
    print(member.user_id)

members, err := client.Voice.RingGroups.Members.List(context.Background(), "RING_GROUP_ID")
if err != nil {
	log.Fatal(err)
}
for _, member := range members.Data {
	fmt.Println(member.UserId)
}

$members = $bird->voice->ringGroups->members->list('RING_GROUP_ID');
foreach ($members->getData() ?? [] as $member) {
    echo $member->getUserId(), "\n";
}

bird voice ring-groups members list <ring-group-id>

curl -X GET "https://us1.platform.bird.com/v1/voice/ring-groups/{ring_group_id}/members" \
  -H "Authorization: Bearer $TOKEN"

Response200

{
  "data": [
    {
      "user_id": "usr_01krdgeqcxet5s7t44vh8rt9mg",
      "created_at": "2026-10-01T12:00:00Z"
    }
  ]
}

Returns the ring group's members, in the order they joined. The default group's members are the users who are online in the browser phone now.

Ring groups require preview access to inbound browser calling. Without it, this returns 404 Not Found.

Parameters

ring_group_idstring

ID of the ring group whose members to list or add to.

Response Payload

data

array of object

required

The members, in the order they joined; the default group's online users, by user ID.

Show child attributes

data.user_id

string

required

The member's user ID.

data.created_at

nullable string

required

When the user joined the ring group. Null for the default group, whose members are the users online now.

Continue with the documentation, guides and examples for this topic.

Get an implementation brief

const members = await bird.voice.ringGroups.members.list("RING_GROUP_ID");
for (const member of members.data) {
  console.log(member.user_id);
}

members = client.voice.ring_groups.members.list("RING_GROUP_ID")
for member in members.data:
    print(member.user_id)

members, err := client.Voice.RingGroups.Members.List(context.Background(), "RING_GROUP_ID")
if err != nil {
	log.Fatal(err)
}
for _, member := range members.Data {
	fmt.Println(member.UserId)
}

$members = $bird->voice->ringGroups->members->list('RING_GROUP_ID');
foreach ($members->getData() ?? [] as $member) {
    echo $member->getUserId(), "\n";
}

bird voice ring-groups members list <ring-group-id>

curl -X GET "https://us1.platform.bird.com/v1/voice/ring-groups/{ring_group_id}/members" \
  -H "Authorization: Bearer $TOKEN"

Response200

{
  "data": [
    {
      "user_id": "usr_01krdgeqcxet5s7t44vh8rt9mg",
      "created_at": "2026-10-01T12:00:00Z"
    }
  ]
}

List a ring group's members

Parameters

Response Payload

Related resources