Presence

This endpoint provides near-real-time participant presence data^[0].

/presence accepts no options and quickly returns all active participants the requestor can see, grouped by room.

/presence vs /meetings vs /logs

Please use this endpoint (not /meetings) if you need to know the current state of rooms and participants. If you need more in-depth analytics please see Meeting Analytics or Logs.

The "presence" object

1{
2  "cool-room": [
3    {
4      "id": "4c8dee53-fd51-445c-92d4-917701401d14",
5      "userId": "309cf686-64ba-4afa-9e6b-05fe13c56fbf",
6      "userName": "sean",
7      "joinTime": "2020-11-01T23:46:38.000Z",
8      "duration": 543,
9      "room": "cool-room"
10    },
11    ... more participants ...
12  ]
13}
14

Example request

1curl -H "Content-Type: application/json" \
2     -H "Authorization: Bearer DAILY_API_KEY" \
3     https://api.daily.co/v1/presence
4

Note: It should be sufficient to query this endpoint no more frequently than once every 15 seconds to get a complete picture of all of the participants on your domain.

^[0] delay of up to 15 seconds.