---
title: "Get Unified Presence"
method: GET
path: "/restapi/v1.0/account/{accountId}/extension/{extensionId}/unified-presence"
tags: ["Presence"]
---

# Get Unified Presence

`GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/unified-presence`

## Request

- Base URL: `https://platform.ringcentral.com`
- URL: `https://platform.ringcentral.com/restapi/v1.0/account/{accountId}/extension/{extensionId}/unified-presence`
- Auth: OAuth 2
  - Authorization code: `https://platform.ringcentral.com/restapi/oauth/authorize`
  - Token URL: `https://platform.ringcentral.com/restapi/oauth/token`
- TypeScript: <https://skmtc.dev/ringcentral/apis/ringcentral-api/docs/restapi/v1.0/account/:accountId/extension/:extensionId/unified-presence/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the unified presence status of the requested user(s). The set of parameters returned by this method differs whether you return the requester's presence or any other user presence.

## Path parameters

- `accountId` string, required
- `extensionId` string, required

## Response `200`

OK

- UnifiedPresence
  - `status` 'Available' | 'Offline' | 'DND' | 'Busy': Aggregated presence status of the user
  - `glip` UnifiedPresenceGlip: Returned if *Glip* feature is switched on
    - `status` 'Offline' | 'Online': Glip connection status calculated from all user's apps. Returned always for the requester's extension; returned for another users if their glip visibility is set to 'Visible'
    - `visibility` 'Visible' | 'Invisible': Visibility setting allowing other users to see the user's Glip presence status; returned only for requester's extension
    - `availability` 'Available' | 'DND': Shows whether user wants to receive Glip notifications or not.
  - `telephony` UnifiedPresenceTelephony: Returned if *BLF* feature is switched on
    - `status` 'NoCall' | 'Ringing' | 'CallConnected' | 'OnHold' | 'ParkedCall': Telephony status calculated from all user's phone numbers. Returned always for the requester's extension; returned for another users if their telephony visibility is set to 'Visible'
    - `visibility` 'Visible' | 'Invisible': Specifies if the user's phone presence status is visible to other users; returned only for requester's extension
    - `availability` 'TakeAllCalls' | 'DoNotAcceptAnyCalls' | 'DoNotAcceptQueueCalls': Telephony DND status. Returned if *DND* feature is switched on
  - `meeting` UnifiedPresenceMeeting: Returned if *Meetings* feature is switched on
    - `status` 'NoMeeting' | 'InMeeting': Meeting status calculated from all user`s meetings

## Other responses

- `207`: Multi-Status
- `400`: Some of the parameters are missing or have invalid format
- `404`: Resource not found

---

[API](https://skmtc.dev/ringcentral/apis/ringcentral-api.md) - [All operations](https://skmtc.dev/ringcentral/apis/ringcentral-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ringcentral/apis/ringcentral-api/revisions/8d602198ec97?raw)