Jump to: navigation, search

Query Server Status

ApiRef2.png GET /server/status
Available since


Queries the status of the Universal Contact Server (UCS). The status that is returned includes in particular the Server Mode (production or maintenance), but it also includes additional information and valuable counters to analyse the activity of the UCS.

Some counters, such as "request_today", "client_errors_today", and "server_errors_today", are not persistent. They are automatically reset if the UCS is restarted.


Query Server Status
Method GET
URL /server/status


The Context Management Service API answers with HTTP codes for every request. The following table shows the correct response for a successful request. See HTTP Response Codes and Errors for further details on the possible codes that this operation can return.

HTTP code 200
HTTP message OK
Name   Type   Description
version string The version of the UCS.
system_time date/time The system time. The date/time format is "yyyy-MM-ddTHH:mm:ss.SSSZ".
mode token
  • production
  • maintenance
The Server Mode.
max_memory long The maximum amount of memory the JVM will attempt to use, in KB.
allocated_memory integer The amount of memory currently in use by the JVM, in KB.
free_memory integer The total memory available to the JVM, in KB.
started date/time<ref name="format"/> Start date of the UCS.
last_request date/time The time of the last web service request.



 GET /server/status


 "max_memory" : 518464,
 "server_errors_today" : 0,
 "client_errors_today" : 0,
 "request_today" : 0,
 "system_time" : "2010-02-24T15:56:46.369Z",
 "used_memory" : 7947,
 "allocated_memory" : 63936,
 "started" : "2010-02-24T14:35:28.668Z",
 "free_memory" : 55989,
 "last_request" : "2010-02-24T14:35:27.964Z",
 "mode" : "production",
 "version" : ""

Comment on this article:

blog comments powered by Disqus
This page was last modified on 27 April 2017, at 03:04.