GetACDOperatorStatusStatistics

POST

https://api.voximplant.com/platform_api/GetACDOperatorStatusStatistics

POST

/platform_api/GetACDOperatorStatusStatistics

curl -X POST "https://api.voximplant.com/platform_api/GetACDOperatorStatusStatistics?from_date=2026-04-28%2017%3A30%3A00&user_id=string" \
     -H "Authorization: Bearer <token>"

200Example 1

{
  "result": [
    {
      "user_id": 487576,
      "statistics": [
        {
          "date": "2019-05-20",
          "hour": 11,
          "acd_status": {
            "READY": {
              "min": 151,
              "avg": 1323,
              "max": 2496,
              "count": 2,
              "sum": 2647
            },
            "ONLINE": {
              "min": 14,
              "avg": 101,
              "max": 267,
              "count": 3,
              "sum": 303
            }
          }
        },
        {
          "date": "2019-05-20",
          "hour": 12,
          "acd_status": {
            "READY": {
              "min": 1169,
              "avg": 1169,
              "max": 1169,
              "count": 1,
              "sum": 1169
            },
            "ONLINE": {
              "min": 27,
              "avg": 1139,
              "max": 2252,
              "count": 2,
              "sum": 2279
            }
          }
        }
      ]
    },
    {
      "user_id": 487578,
      "statistics": [
        {
          "date": "2019-05-20",
          "hour": 11,
          "acd_status": {
            "READY": {
              "min": 42,
              "avg": 234,
              "max": 472,
              "count": 4,
              "sum": 939
            },
            "ONLINE": {
              "min": 24,
              "avg": 955,
              "max": 1886,
              "count": 2,
              "sum": 1911
            }
          }
        },
        {
          "date": "2019-05-20",
          "hour": 12,
          "acd_status": {
            "ONLINE": {
              "min": 2350,
              "avg": 2350,
              "max": 2350,
              "count": 1,
              "sum": 2350
            }
          }
        }
      ]
    }
  ]
}

Get statistics for the specified operators and ACD statuses. This method can filter statistics by operator ids and statuses. It can also group results by day/hour or users.

Allowed roles: Owner, Admin, Developer, Supervisor, User manager.

Example request: Get statistics for the ‘READY’ and ‘ONLINE’ statuses of all operators; grouped by operators.

Authentication

AuthorizationBearer

Voximplant Management API uses signed JWT tokens generated from your service-account private key. Pass the token in the Authorization header as a Bearer value:

Authorization: Bearer $VOXIMPLANT_TOKEN

See Authorization for ready-to-copy snippets in bash, Python, Node.js and Go that turn your credentials.json into a token.

Query parameters

from_datestringRequired

Date and time of statistics interval begin. Time zone is UTC, format is 24-h 'YYYY-MM-DD HH:mm:ss'

to_datestringOptionalDefaults to current date and time

Date and time of statistics interval begin. Time zone is UTC, format is 24-h 'YYYY-MM-DD HH:mm:ss'

acd_statuslist of stringsOptional

The ACD status list separated by semicolons (;). The following values are possible: OFFLINE, ONLINE, READY, BANNED, IN_SERVICE, AFTER_SERVICE, TIMEOUT, DND

user_idlist of stringsRequired

The user ID list separated by semicolons (;). Use the 'all' value to select all users

aggregationstringOptionalDefaults to none

Specifies how records are grouped by date and time. If set to 'day', the criteria is a day number. If set to 'hour_of_day', the criteria is a 60-minute interval within a day. If set to 'hour', the criteria is both day number and 60-minute interval within that day. If set to 'none', records are not grouped by date and time

groupstringOptionalDefaults to user

If set to 'user', first-level array in the resulting JSON groups records by the user ID, and second-level array groups them by date according to the 'aggregation' parameter. If set to 'aggregation', first-level array in the resulting JSON groups records according to the 'aggregation' parameter, and second-level array groups them by the user ID

Response

Successful response

resultlist of objectsOptional

List of groups, grouped by user ID or date according to the 'group' method call argument