GetSystemStatistics API¶
Retrieves system-wide statistics including user counts, document counts, total document storage size, the number of checked-out documents, and the number of documents registered in the last 30, 60, and 90 days.
Endpoint¶
Methods¶
- GET
/srv.asmx/GetSystemStatistics?authenticationTicket=... - POST
/srv.asmx/GetSystemStatistics(form data) - SOAP Action:
http://tempuri.org/GetSystemStatistics
Parameters¶
| Parameter | Type | Required | Description |
|---|---|---|---|
authenticationTicket |
string | Yes | Authentication ticket obtained from AuthenticateUser |
Response¶
Success Response¶
<root success="true">
<SystemStatistics>
<TotalUserCount>150</TotalUserCount>
<ActiveUserCount>140</ActiveUserCount>
<DisabledUserCount>10</DisabledUserCount>
<TotalDocumentCount>25000</TotalDocumentCount>
<TotalDocumentSize>10737418240</TotalDocumentSize>
<TotalCheckedOutDocuments>12</TotalCheckedOutDocuments>
<RegisteredDocumentsIn30Days>87</RegisteredDocumentsIn30Days>
<RegisteredDocumentsIn60Days>210</RegisteredDocumentsIn60Days>
<RegisteredDocumentsIn90Days>345</RegisteredDocumentsIn90Days>
</SystemStatistics>
</root>
Error Response¶
Response Fields¶
| Field | Type | Description |
|---|---|---|
TotalUserCount |
int | Total number of user accounts (active + disabled), excluding the system admin account |
ActiveUserCount |
int | Number of active (non-disabled) users (authors + read-only users) |
DisabledUserCount |
int | Number of disabled user accounts |
TotalDocumentCount |
int | Total number of documents stored in the system |
TotalDocumentSize |
long | Total size of all document versions in bytes |
TotalCheckedOutDocuments |
int | Number of documents currently checked out |
RegisteredDocumentsIn30Days |
int | Number of documents registered within the last 30 days |
RegisteredDocumentsIn60Days |
int | Number of documents registered within the last 60 days |
RegisteredDocumentsIn90Days |
int | Number of documents registered within the last 90 days |
Required Permissions¶
The caller must have the ViewServerStatus admin permission.
Example¶
Request (GET)¶
Request (POST)¶
POST /srv.asmx/GetSystemStatistics HTTP/1.1
Content-Type: application/x-www-form-urlencoded
authenticationTicket=abc123-...
Notes¶
TotalUserCountexcludes the built-in system administrator account.TotalDocumentSizeis calculated from the VERSIONS table and reflects the sum of all stored version sizes in bytes.TotalCheckedOutDocumentscounts all documents currently locked for editing across all libraries.RegisteredDocumentsIn30Days,RegisteredDocumentsIn60Days, andRegisteredDocumentsIn90Dayscount documents whoseREGISTERDATEfalls within the last 30, 60, or 90 days respectively. Only documents in active libraries (DOMAINTYPE=0) are included; recycle bin documents are excluded.