listMembers | SignalWire

List members for a particular video room session.

Path parameters

idstringRequiredformat: "uuid"

Unique ID of the Room Session.

Query parameters

page_numberintegerOptional>=0Defaults to 0

Page number to return. Requires `page_token` for values greater than 0.

page_sizeintegerOptional1-1000Defaults to 50

Specify the number of results to return on a single page. The default page size is `50` and the maximum is `1000`.

page_tokenstringOptional

Token for cursor-based pagination. Required when `page_number` is greater than 0.

Response

linksobjectRequired

Pagination links.

datalist of objectsRequired

List of room session members.

Response Example

Response

{
  "links": {
    "self": "https://example.signalwire.com/api/video/rooms?page=2",
    "first": "https://example.signalwire.com/api/video/rooms?page=1",
    "next": "https://example.signalwire.com/api/video/rooms?page=3",
    "prev": "https://example.signalwire.com/api/video/rooms?page=1"
  },
  "data": [
    {
      "id": "c22d24f6-5a47-4597-9a23-c7d01e696b92",
      "room_session_id": "a1b2c3d4-5e6f-7890-abcd-ef1234567890",
      "name": "John Smith",
      "join_time": "2022-01-01T10:00:00Z",
      "leave_time": "2022-01-01T11:00:00Z",
      "duration": 120,
      "cost_in_dollars": 0.05
    }
  ]
}

Example

import { RestClient } from "@signalwire/sdk";
const client = new RestClient({
  project: "your-project-id",
  token: "your-api-token",
  host: "your-space.signalwire.com",
});
const members = await client.video.roomSessions.listMembers("session-id");
for (const member of members.data ?? []) {
  console.log(`${member.name}: ${member.id}`);
}