Skip to API content
TalkLabs API Docs v3
Recipes
GET Chat

List Room Participants

Use this method to cursor through the people who have subscribe to the room.

GET /api/v3/{appid}/chat/rooms/{roomid}/participants

This method requires authentication.

Use this method to cursor through the people who have subscribe to the room.

To cursor through the results if there are many participants, invoke this function many times. Each result will return a cursor value and you can pass that value to the next invokation to get the next page of results. The result set will also include a next field with the full URL to get the next page, so you can just keep reading that and requesting that URL until you reach the end. When you reach the end, no more results will be returned or the result set will be less than maxresults and the next field will be empty.

Request

Parameters

Values in the path and query string.

appid path
string TalkLabs ID required

The TalkLabs application ID assigned to your account.

Example: your-app-id
roomid path
string TalkLabs ID required

The TalkLabs assigned room ID returned when the room was created.

Example: room-id
Cursor query
string

The cursor returned by the previous page.

Limit query
integer · int32

The maximum number of records to return.

Example: 50
Response

Status codes

Every JSON response uses the API result envelope.

200 OK ApiResult
400 Bad Request ApiResult
403 Forbidden ApiResult
404 Not Found ApiResult
500 Internal Server Error ApiResult
Example response · 200
{
  "message": "Success",
  "errors": {},
  "data": {
    "kind": "list.chatparticipants",
    "cursor": "5ec4aa045617e40ed4e82aac",
    "participants": [
      {
        "kind": "chat.participant",
        "user": {
          "kind": "app.user",
          "userid": "userid_abe",
          "handle": "HonestAbe",
          "handlelowercase": "honestabe",
          "displayname": "Abraham Lincoln",
          "pictureurl": "https://www.biography.com/.image/ar_1:1%2Cc_fill%2Ccs_srgb%2Cg_face%2Cq_auto:good%2Cw_300/MTU5MDUzMTE0Mzk2MTI0OTUy/abraham-lincoln-1809---18652c-sixteenth-president-of-the-united-states-of-america-photo-by-stock-montagestock-montagegetty-images_promo.jpg",
          "profileurl": "https://www.biography.com/us-president/abraham-lincoln",
          "banned": false
        }
      }
    ]
  }
}
Search all 118 endpoints Try “join room”, “moderate”, or “POST”.
Request environment

Connect your application

These values fill request examples and the API console. They stay in this browser tab and are never sent to TalkLabs until you run a request.

Credentials are stored in sessionStorage, not in cookies or analytics.