Returns every media call the authenticated user is part of and that has
not yet ended. Each entry reflects the call's latest
server-side state — ringing, active, etc. It also includes the
caller, callee, supported features, and lifecycle timestamps.
The user ID.
The authentication token.
The list of in-flight calls for the authenticated user.
Outbound call is still ringing
{
"calls": [
{
"_id": "9f44ec94-2046-4fac-976b-fa8b0e022b08",
"service": "webrtc",
"kind": "direct",
"state": "ringing",
"createdBy": {
"type": "user",
"id": "aEGCdnFoBFCFNdiyX",
"contractId": "7b96e74d-1e01-412a-8bcb-145db1bc9ac4"
},
"createdAt": "2026-04-30T13:30:53.165Z",
"caller": {
"type": "user",
"id": "aEGCdnFoBFCFNdiyX",
"contractId": "7b96e74d-1e01-412a-8bcb-145db1bc9ac4",
"displayName": "Funke Olasupo",
"username": "funke.olasupo"
},
"callee": {
"type": "user",
"id": "iaZWAXecuCuBx4FnX",
"displayName": "Agent1",
"username": "agent1"
},
"expiresAt": "2026-04-30T13:33:02.878Z",
"uids": [
"aEGCdnFoBFCFNdiyX",
"iaZWAXecuCuBx4FnX"
],
"ended": false,
"callerRequestedId": "7b96e74d-1e01-412a-8bcb-145db1bc9ac4-38b61a15-8c41-4ee4-be75-977c48cd94ea",
"features": [
"audio",
"screen-share",
"transfer",
"hold"
],
"_updatedAt": "2026-04-30T13:31:02.878Z"
}
],
"success": true
}Call has been picked up and is active
{
"calls": [
{
"_id": "9f44ec94-2046-4fac-976b-fa8b0e022b08",
"service": "webrtc",
"kind": "direct",
"state": "active",
"createdBy": {
"type": "user",
"id": "aEGCdnFoBFCFNdiyX",
"contractId": "7b96e74d-1e01-412a-8bcb-145db1bc9ac4"
},
"createdAt": "2026-04-30T13:30:53.165Z",
"caller": {
"type": "user",
"id": "aEGCdnFoBFCFNdiyX",
"contractId": "7b96e74d-1e01-412a-8bcb-145db1bc9ac4",
"displayName": "Funke Olasupo",
"username": "funke.olasupo"
},
"callee": {
"type": "user",
"id": "iaZWAXecuCuBx4FnX",
"contractId": "7488b84e-e096-46fb-8d62-1e6e3db479c9",
"displayName": "Agent1",
"username": "agent1"
},
"expiresAt": "2026-04-30T13:33:12.993Z",
"uids": [
"aEGCdnFoBFCFNdiyX",
"iaZWAXecuCuBx4FnX"
],
"ended": false,
"callerRequestedId": "7b96e74d-1e01-412a-8bcb-145db1bc9ac4-38b61a15-8c41-4ee4-be75-977c48cd94ea",
"features": [
"audio",
"screen-share",
"transfer",
"hold"
],
"_updatedAt": "2026-04-30T13:31:12.993Z",
"acceptedAt": "2026-04-30T13:31:10.070Z",
"activatedAt": "2026-04-30T13:31:12.698Z"
}
],
"success": true
}User has no in-flight calls
{
"calls": [],
"success": true
}All in-flight calls the authenticated user participates in.
Unique identifier of the call.
Underlying media service powering the call.
Call topology.
Current lifecycle state of the call.
ringing: invitation sent, callee has not yet answered.active: call accepted and media is flowing.
The actor who created the call.
Rocket.Chat user id.
Device/session contract id registered with the media-call service.
When the call record was created on the server.
The party initiating the call. Always carries contractId.
The party being called. contractId is omitted while
the call is ringing (no device has answered yet)
and populated once accepted.
Set once the call is accepted.
When the current state will expire if no further activity occurs.
User IDs of every participant in the call.
Always false for entries returned by this endpoint.
Client-supplied correlation id for the call request.
Feature flags negotiated for this call.
When the call record was last updated.
Set once the callee accepts. Absent while ringing.
Set once media becomes active. Absent while ringing.
Unauthorized
{
"status": "error",
"message": "You must be logged in to do this."
}