---
title: "Get a user's presence status"
method: GET
path: "/users/{userId}/presences"
tags: ["presences", "users"]
---

# Get a user's presence status

`GET /users/{userId}/presences`

Retrieves the current presence status for a specific user — whether they are available, on a call, in snooze mode, or offline. The presence data includes the user's current availability state, active snooze information (if any), and the device they are connected from.

**Permission:** `Users Read` required.

**Monitoring impact:**
- **OFF:** Returns presence only if `userId` matches **your own** user ID. Requesting another user's presence returns `404`.
- **ON:** Returns **any user's** presence in the team. For a bulk view of all team presences, use `GET /presences` instead (also requires Monitoring ON).

## Path parameters

- `userId` integer, required

## Response `200`

Successful operation

- 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

- `400` — The provided user ID is invalid
- `401` — Authentication token is missing, invalid, expired, or Users Read permission is missing
- `404` — No user found with the specified ID (or you do not have access to this user without monitoring)
- `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)