List room participants

View as Markdown
List active [room participants](/api/room-participants), sorted by session `uuid` in ascending order. This endpoint returns one non-paginated result. Omitting `limit` returns every participant when the full result set is within the system result ceiling. Setting `limit` returns at most that many participants and sets `has_more` to `true` when additional participants matched. The system checks the full result set against its ceiling before applying `limit`. If the full set exceeds the ceiling, the request returns `413` and a smaller `limit` cannot make it succeed.

Authentication

AuthorizationBearer
Application auth. Send `Authorization: Bearer <app_uuid>:<api_key>` using any active key in the app's collection. See [Authentication](https://voice-platform.docs.buildwithfern.com/api/authentication) for details.

Path parameters

room_idstringRequired

Case-sensitive room identifier.

Query parameters

limitintegerOptional>=1

Sets the maximum number of participants in the response. Omitting it returns every participant when the full result set is within the system ceiling. A non-positive value returns 400.

Response

Participants of the room
has_moreboolean

true when more participants matched than limit allowed; raise limit to retrieve all of them.

participantslist of objects
room_idstring

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
413
Content Too Large Error
500
Internal Server Error