---
title: "List all team presences"
method: GET
path: "/presences"
tags: ["presences"]
---

# List all team presences

`GET /presences`

Retrieves presence information for **all users** in your team in a single request. Each entry includes the user's current availability state (available, on call, in snooze, offline), active snooze details, and connected device. This is the bulk equivalent of `GET /users/{userId}/presences` — ideal for building a team dashboard or monitoring panel.

**Permission:** No specific permission required. A valid API key is sufficient.

**Monitoring:** **Required.** This is a team-wide supervisory view. Returns `401 Unauthorized` if Monitoring is OFF on your API key. For individual user presence without Monitoring, use `GET /users/{userId}/presences` instead.

## Response `200`

Successful operation

- UsersPresences
  - `list_count` integer — The size of the array <em>list</em>, corresponds to the number of presences retrieved
  - `list` UserPresences[]
    - `team_id` integer — The user's team id
    - `user_id` integer — The user's id
    - `in_call` integer — Number of current calls (it can be more than 1)
    - `connected_devices` integer — Number of devices connected to myringover
    - `planning_enable` boolean — True if the user have the planning option activated on myringover
    - `is_planning` boolean — True if the user is currently in his planning schedule
    - `is_planned_snooze` boolean — False if the user is currently in his planning schedule
    - `is_snoozed` boolean — True if the user is currently in snooze
    - `snooze_type` string — The type of snooze currently used. Null if is_snoozed is false
    - `snooze_end` string — End date/time of the snooze

## Other responses

- `401` — Authentication token is missing, invalid, expired, or monitoring is not enabled on the API key
- `500` — Internal server error

---

[API](https://skmtc.net/ringover/apis/ringover-public-api.md) · [All operations](https://skmtc.net/ringover/apis/ringover-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringover/ringover-public-api/revisions/9da73dd2f99e/schema)