Get Time Series Analytics
get_time_series_analyticsFull Description
Get time series analytics data for conversations, including metrics like response times, resolution times, conversation counts, and more. Optionally scope with dateRange or both startDate and endDate — defaults to the last 30 days when no range is given. Supports filtering and grouping by various dimensions. For custom fields: First use list_custom_fields to find field IDs by name, then use format 'ticketTypeFields.{fieldId}' in dimensions/filters.
Parameters (2 required, 7 optional)
metricstringThe metric to calculate
responseTimeMeanresponseTimeWorkingMeanresolutionTimeMeanresolutionTimeWorkingMeanresponseTimeMedianresponseTimeWorkingMedianresolutionTimeMedianresolutionTimeWorkingMediantotalCountconversationsResolvedconversationsResolvedInSameDatePeriodsentimentScoreMeanresponseTimeP95responseTimeWorkingP95responseTimeP99responseTimeWorkingP99resolutionTimeP95resolutionTimeWorkingP95resolutionTimeP99resolutionTimeWorkingP99waitingOnAgentTimeWorkingMeanwaitingOnAgentTimeWorkingMedianwaitingOnAgentTimeWorkingP95waitingOnAgentTimeWorkingP99waitingOnAgentTimeMeanwaitingOnAgentTimeMedianwaitingOnAgentTimeP95waitingOnAgentTimeP99waitingOnCustomerTimeMeanwaitingOnCustomerTimeMedianwaitingOnCustomerTimeP95waitingOnCustomerTimeP99waitingOnCustomerTimeWorkingMeanwaitingOnCustomerTimeWorkingMedianwaitingOnCustomerTimeWorkingP95waitingOnCustomerTimeWorkingP99activeDurationMeanactiveDurationWorkingMeanactiveDurationMedianactiveDurationWorkingMedianactiveDurationP95activeDurationWorkingP95activeDurationP99activeDurationWorkingP99ticketToEscalationDurationMeanticketToEscalationDurationWorkingMeanticketToEscalationDurationMedianticketToEscalationDurationWorkingMedianticketToEscalationDurationP95ticketToEscalationDurationWorkingP95ticketToEscalationDurationP99ticketToEscalationDurationWorkingP99escalationToAcknowledgementDurationMeanescalationToAcknowledgementDurationWorkingMeanescalationToAcknowledgementDurationMedianescalationToAcknowledgementDurationWorkingMedianescalationToAcknowledgementDurationP95escalationToAcknowledgementDurationWorkingP95escalationToAcknowledgementDurationP99escalationToAcknowledgementDurationWorkingP99acknowledgementToResolutionDurationMeanacknowledgementToResolutionDurationWorkingMeanacknowledgementToResolutionDurationMedianacknowledgementToResolutionDurationWorkingMedianacknowledgementToResolutionDurationP95acknowledgementToResolutionDurationWorkingP95acknowledgementToResolutionDurationP99acknowledgementToResolutionDurationWorkingP99escalationCountdeflectionCountdeflectionRatedeflectionBackAndForthMeantimezonestringTimezone for date calculations (e.g., 'America/New_York', 'UTC')
dateDimensionstringTime dimension for grouping data
dayweekmonthquartertotaldateRangeobjectDate range for the analysis. Provide this, or provide both startDate and endDate. Defaults to the last 30 days when neither is given.
dimensionsarrayArray of dimensions to group by. Standard dimensions: 'assigneeId', 'customerId', 'tagId', 'sourceType', 'status', 'priority', etc. For custom fields: use 'ticketTypeFields.{fieldId}' format - get fieldId from list_custom_fields tool.
endDatestringEnd date in YYYY-MM-DD format, inclusive. Provide with startDate when not using dateRange.
filtersobjectFilters to apply to the data. Use either a record of field names to JSON values, or an array of { field, operator, value } clauses. For custom field IDs, use list_custom_fields tool first and pass 'ticketTypeFields.{fieldId}'.
projectIdstringAuthorized project scope. Omit or pass null only when requesting tenant-wide reporting.
startDatestringStart date in YYYY-MM-DD format, inclusive. Provide with endDate when not using dateRange.