Get Offline Agents

GET {{baseUrl}}/v1/offlineAgents?departmentId=<long>

This API lists the agents who are currently offline in a particular department.

OAuth Scope

  • Desk.settings.READ
  • Desk.basic.READ

Request Params

KeyDatatypeRequiredDescription
departmentIdstringID of the department from which the availability details should be fetched. To include all accessible departments, pass the value of this key as -1.
includestringKey that includes additional, channel-specific information. Values allowed are: mailStatus, phoneStatus, phoneMode, chatStatus, and presenceStatus.
limitstringNumber of agents to list. The default value is 20 and the maximum value allowed is 6000.

HEADERS

KeyDatatypeRequiredDescription
Authorizationstring

RESPONSES

status: OK

{&quot;data&quot;:[{&quot;chatStatus&quot;:&quot;ONLINE&quot;,&quot;agentId&quot;:&quot;892000000008734&quot;,&quot;phoneMode&quot;:&quot;WEB&quot;,&quot;phoneStatus&quot;:&quot;ONLINE&quot;,&quot;mailStatus&quot;:&quot;OFFLINE&quot;,&quot;presenceStatus&quot;:&quot;OFFLINE&quot;,&quot;status&quot;:&quot;OFFLINE&quot;},{&quot;chatStatus&quot;:&quot;ONLINE&quot;,&quot;agentId&quot;:&quot;8920000000056010&quot;,&quot;phoneMode&quot;:&quot;WEB&quot;,&quot;phoneStatus&quot;:&quot;ONLINE&quot;,&quot;mailStatus&quot;:&quot;OFFLINE&quot;,&quot;presenceStatus&quot;:&quot;OFFLINE&quot;,&quot;status&quot;:&quot;OFFLINE&quot;}],&quot;totalAgentsCount&quot;:&quot;2&quot;,&quot;hasMore&quot;:false}