v50

latestOpenAPI 3.0.1Apache 2.0raw.githubusercontent.com2026-02-056136556.2 KB
TaskrouterV1TaskQueueCumulativeStatistics

get/v1/Workspaces/{WorkspaceSid}/TaskQueues/{TaskQueueSid}/CumulativeStatistics

Path parameters

WorkspaceSidstring required

The SID of the Workspace with the TaskQueue to fetch.

TaskQueueSidstring required

The SID of the TaskQueue for which to fetch statistics.

Query parameters

EndDatestring date-time

Only calculate statistics from this date and time and earlier, specified in GMT as an ISO 8601 date-time.

Minutesinteger

Only calculate statistics since this many minutes in the past. The default is 15 minutes.

StartDatestring date-time

Only calculate statistics from this date and time and later, specified in ISO 8601 format.

TaskChannelstring

Only calculate cumulative statistics on this TaskChannel. Can be the TaskChannel's SID or its unique_name, such as voice, sms, or default.

SplitByWaitTimestring

A comma separated list of values that describes the thresholds, in seconds, to calculate statistics on. For each threshold specified, the number of Tasks canceled and reservations accepted above and below the specified thresholds in seconds are computed. TaskRouter will calculate statistics on up to 10,000 Tasks/Reservations for any given threshold.

Response

OK

account_sidstring nullable

The SID of the Account that created the TaskQueue resource.

avg_task_acceptance_timeinteger

The average time in seconds between Task creation and acceptance.

start_timestring date-time nullable

The beginning of the interval during which these statistics were calculated, in ISO 8601 format.

end_timestring date-time nullable

The end of the interval during which these statistics were calculated, in ISO 8601 format.

reservations_createdinteger

The total number of Reservations created for Tasks in the TaskQueue.

reservations_acceptedinteger

The total number of Reservations accepted for Tasks in the TaskQueue.

reservations_rejectedinteger

The total number of Reservations rejected for Tasks in the TaskQueue.

reservations_timed_outinteger

The total number of Reservations that timed out for Tasks in the TaskQueue.

reservations_canceledinteger

The total number of Reservations canceled for Tasks in the TaskQueue.

reservations_rescindedinteger

The total number of Reservations rescinded.

{"stackTrail":"components:schemas:taskrouter.v1.workspace.task_queue.task_queue_cumulative_statistics:properties:split_by_wait_time","oasType":"schema","type":"unknown","description":"A list of objects that describe the number of Tasks canceled and reservations accepted above and below the thresholds specified in seconds.","nullable":true}
task_queue_sidstring nullable

The SID of the TaskQueue from which these statistics were calculated.

{"stackTrail":"components:schemas:taskrouter.v1.workspace.task_queue.task_queue_cumulative_statistics:properties:wait_duration_until_accepted","oasType":"schema","type":"unknown","description":"The wait duration statistics (`avg`, `min`, `max`, `total`) for Tasks accepted while in the TaskQueue. Calculation is based on the time when the Tasks were created. For transfers, the wait duration is counted from the moment ***the Task was created***, and not from when the transfer was initiated.","nullable":true}
{"stackTrail":"components:schemas:taskrouter.v1.workspace.task_queue.task_queue_cumulative_statistics:properties:wait_duration_until_canceled","oasType":"schema","type":"unknown","description":"The wait duration statistics (`avg`, `min`, `max`, `total`) for Tasks canceled while in the TaskQueue.","nullable":true}
{"stackTrail":"components:schemas:taskrouter.v1.workspace.task_queue.task_queue_cumulative_statistics:properties:wait_duration_in_queue_until_accepted","oasType":"schema","type":"unknown","description":"The relative wait duration statistics (`avg`, `min`, `max`, `total`) for Tasks accepted while in the TaskQueue. Calculation is based on the time when the Tasks entered the TaskQueue.","nullable":true}
tasks_canceledinteger

The total number of Tasks canceled in the TaskQueue.

tasks_completedinteger

The total number of Tasks completed in the TaskQueue.

tasks_deletedinteger

The total number of Tasks deleted in the TaskQueue.

tasks_enteredinteger

The total number of Tasks entered into the TaskQueue.

tasks_movedinteger

The total number of Tasks that were moved from one queue to another.

workspace_sidstring nullable

The SID of the Workspace that contains the TaskQueue.

urlstring uri nullable

The absolute URL of the TaskQueue statistics resource.