---
title: "List presence"
method: GET
path: "/beta/teams/{teamId}/presence"
tags: ["Teams"]
---

# List presence

`GET /beta/teams/{teamId}/presence`

List the presence status of all agents/admins in a team.

## Path parameters

- `teamId` string, uuid, required

## Query parameters

- `pageLimit` integer
- `pageKey` string

## Response `200`

List of agents/admins presence status in the specified team

- ListPresenceOutput
  - `data` UserPresence[]
    - `userId` string, required
    - `requestTime` string, required
    - `lastSeen` string
    - `presenceStatus` string — values: [Away, Working]
    - `connectionStatus` string, required — values: [Offline, Online]
    - `activeChannels` string[]
  - `meta` PaginationLinks
    - `previous` string — url
    - `next` string — url

## Other responses

- `400` — Invalid value for: path parameter teamId, Invalid value extracted from request context, Invalid value for: query parameter pageLimit, Invalid value for: query parameter pageKey
- `404` — An entity in this request could not be found
- `500` — Internal failure during request processing

---

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