Get Presence

Returns the online status of the calling user.

Get presence information about the requesting user.

get

/v2/user/presence

Header parameters

sessionTokenstringrequired

Session authentication token.

Responses

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'yourpodURL.symphony.com/pod/v2/user/presence' \
  --header 'sessionToken: text'

200

400

401

500

200

{
  "category": "AVAILABLE",
  "userId": 14568529068038,
  "timestamp": 1533928483800
}

OK

When calling this as an OBO-enabled endpoint, use the OBO User Authenticate token for sessionToken.

The available online status values (presence categories) for users are:

Presence category	Interface icon	External view	Comment
AVAILABLE	Green check mark	AVAILABLE	Released in 1.46
AWAY	Yellow clock	AWAY	Released in 1.46
OFFLINE	Grey cross	OFFLINE	Introduced in 20.16
BUSY	Red sign	BUSY	Released in 1.46
ON_THE_PHONE	Red phone	ON_THE_PHONE	Released in 1.46
BE_RIGHT_BACK	Yellow clock	AWAY	Released in 1.47
IN_A_MEETING	Red phone	IN_A_MEETING	Released in 1.47
OUT_OF_OFFICE	Purple circle	OUT_OF_OFFICE	Released in 1.47
OFF_WORK	Yellow clock	OFFLINE	Deprecated in 20.16
DO_NOT_DISTURB	Red circle	AWAY	Deprecated in 20.16

See Set Presence for a description of the Presence category and External view values for internal and external users.

Note: It is also possible for Symphony users to have other presence values, which should be handled in your implementation as edge cases.