Get Current Availability

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

This API lists the current availability of agents 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 and the maximum value allowed is 20.
fromstringIndex number, starting from which the agents must be fetched. The default value is 0 and the maximum value allowed is 5999.

HEADERS

KeyDatatypeRequiredDescription
Authorizationstring

RESPONSES

status: OK

{&quot;data&quot;:[{&quot;chatStatus&quot;:&quot;OFFLINE&quot;,&quot;agentId&quot;:&quot;892000000008734&quot;,&quot;phoneMode&quot;:&quot;WEB&quot;,&quot;phoneStatus&quot;:&quot;OFFLINE&quot;,&quot;mailStatus&quot;:&quot;OFFLINE&quot;,&quot;presenceStatus&quot;:&quot;ONLINE&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;ONLINE&quot;,&quot;status&quot;:&quot;ONLINE&quot;}],&quot;totalAgentsCount&quot;:&quot;2&quot;,&quot;hasMore&quot;:false}