List room participants
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
Send `Authorization: Bearer <app_uuid>:<api_key>` using an active API key. See [Authentication](https://voice-platform.docs.buildwithfern.com/api/authentication) for details.
Path parameters
room_id
Case-sensitive room identifier.
Query parameters
limit
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 headers
traceparent
Server-owned W3C Trace Context for correlating this response with support and observability data. It is present on successful and error responses. A valid incoming traceparent is linked to, but never becomes, the server-owned trace identifier.
Response
Participants of the room
has_more
true when more participants matched than limit allowed;
raise limit to retrieve all of them.
participants
room_id
Errors
400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
406
Not Acceptable Error
413
Content Too Large Error
500
Internal Server Error