{"openapi":"3.0.0","info":{"title":"Quality Management API","description":"Zoom Quality Management is designed to help contact centers track and analyze customer interactions, measure agent performance, provide actionable insights, and proactively identify areas for improvement while maintaining organizational compliance. ","termsOfService":"https://zoom.us/docs/en-us/zoom_api_license_and_tou.html","contact":{"name":"Zoom Developers","url":"https://developer.zoom.us/"},"version":"2"},"externalDocs":{"description":"Find out more about Swagger","url":"https://swagger.io"},"servers":[{"url":"https://api.zoom.us/v2"}],"paths":{"/qm/calibrations":{"get":{"tags":["Calibrations"],"summary":"List calibrations","description":"List calibration tasks in Quality Management performance management.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `qm_calibrations:read:admin`,`qm_calibrations:read`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_quality_management:read:calibrations`,`zoom_quality_management:read:calibrations:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"ListCalibrations","parameters":[{"name":"status","in":"query","description":"The calibration's public status.","required":false,"schema":{"type":"string","example":"Active","enum":["Active","Completed","Expired","Canceled"]}},{"name":"agent_id","in":"query","description":"The agent's Zoom user ID.","required":false,"schema":{"type":"string","example":"httgPnTgTxq0d65-alfYVw"}},{"name":"interaction_id","in":"query","description":"The interaction ID.","required":false,"schema":{"type":"string","example":"q9DyYF8iSXa3PVAhb6nekQ"}},{"name":"from","in":"query","description":"Filter calibrations created on or after this time, in `yyyy-MM-dd'T'HH:mm:ss'Z'` format.","required":false,"schema":{"type":"string","example":"2026-07-01T00:00:00Z"}},{"name":"to","in":"query","description":"Filter calibrations created on or before this time, in `yyyy-MM-dd'T'HH:mm:ss'Z'` format.","required":false,"schema":{"type":"string","example":"2026-07-29T23:59:59Z"}},{"name":"page_size","in":"query","description":"Default: 30. Maximum: 100.","required":false,"schema":{"type":"integer","example":30}},{"name":"next_page_token","in":"query","description":"Use the next page token to paginate through large result sets. A next page token is returned whenever the set of available results exceeds the current page size.","required":false,"schema":{"type":"string","example":"R4aF9Oj0fVM2hhezJTEmSKaBSkfesDwGy42"}}],"responses":{"200":{"description":"Successfully listed calibrations.","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"integer","description":"The total number of all the records available across pages.","example":51},"page_size":{"type":"integer","description":"The number of records returned within a single API call.","example":30},"next_page_token":{"type":"string","description":"Use the next page token to paginate through large result sets. A next page token is returned whenever the set of available results exceeds the current page size.","example":"R4aF9Oj0fVM2hhezJTEmSKaBSkfesDwGy42"},"data":{"type":"array","description":"Information about the calibrations.","items":{"type":"object","properties":{"calibration_id":{"type":"string","description":"The calibration task ID.","example":"0e73a69f8f104d24a589fa0c615abca8"},"account_id":{"type":"string","description":"The account ID.","example":"SY-AEWW6Ruqgt89_T2zqBg"},"channel_type":{"type":"string","description":"The interaction's channel type.","example":"VIDEO","enum":["VIDEO","AUDIO","MANUAL","MESSAGE"]},"task_name":{"type":"string","description":"The calibration task name.","example":"calibration_q9DyYF8iSXa3PVAhb6nekQ"},"interaction_id":{"type":"string","description":"The interaction ID.","example":"q9DyYF8iSXa3PVAhb6nekQ"},"scorecard_id":{"type":"string","description":"The calibration scorecard ID.","example":"2uJ4u83yQ_qbyyFDmxsMcQ"},"scorecard_name":{"type":"string","description":"The calibration scorecard name.","example":"Customer Care"},"minimum_evaluators":{"type":"integer","description":"The minimum number of evaluator submissions required to complete the calibration.","example":100},"due_date":{"type":"string","description":"The calibration due date, in `yyyy-MM-dd'T'HH:mm:ss'Z'` format.","example":"2026-08-05T10:45:00Z"},"create_time":{"type":"string","description":"The date when the calibration was created, in `yyyy-MM-dd'T'HH:mm:ss'Z'` format.","example":"2026-07-20T09:52:22Z"},"modify_time":{"type":"string","description":"The date when the calibration was last modified, in `yyyy-MM-dd'T'HH:mm:ss'Z'` format.","example":"2026-07-28T09:52:22Z"},"creator_info":{"type":"object","properties":{"user_id":{"type":"string","description":"The calibration creator's Zoom user ID.","example":"b0_yDuNGSq65EF8i1f0PcQ"},"display_name":{"type":"string","description":"The calibration creator's display name.","example":"Rick Arps"}},"description":"The calibration creator's information."},"agent_info":{"type":"object","properties":{"user_id":{"type":"string","description":"The agent's Zoom user ID.","example":"httgPnTgTxq0d65-alfYVw"},"display_name":{"type":"string","description":"The agent's display name.","example":"Ashlee York"}},"description":"The agent's information."},"evaluators_info":{"type":"array","description":"The evaluators' information.","items":{"type":"object","properties":{"user_id":{"type":"string","description":"The evaluator's Zoom user ID.","example":"b0_yDuNGSq65EF8i1f0PcQ"},"display_name":{"type":"string","description":"The evaluator's display name.","example":"Rick Arps"}}}},"scoring_format":{"type":"string","description":"The scorecard's scoring format.","example":"percentage","enum":["points","percentage"]},"total_score":{"type":"number","description":"The total score on the scorecard.","example":50},"evaluation_score":{"type":"number","description":"The sibling manual evaluation score for the same interaction.","example":42},"calibration_score":{"type":"number","description":"The average score across completed evaluator submissions for the calibration.","example":40},"status":{"type":"string","description":"The calibration's current status.","example":"Active","enum":["Active","Completed","Expired","Canceled"]},"interaction_deleted":{"type":"boolean","description":"Whether the interaction was deleted.","example":false},"completion_date":{"type":"string","description":"The date when the calibration was completed, in `yyyy-MM-dd'T'HH:mm:ss'Z'` format.","example":"2026-03-16T10:45:00Z"}}}}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  Bad request.\n\n "},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  Unauthorized.\n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_authorization":[]}],"x-extensions":{"x-permissions":["InteractionPerformanceMgt:Read","AssignEvaluations:Edit","AllInteractions:Read"],"x-macro-scopes":["qm_calibrations:read:admin","qm_calibrations:read"],"x-granular-scopes":["zoom_quality_management:read:calibrations","zoom_quality_management:read:calibrations:admin"]}}},"/qm/calibrations/{calibrationId}":{"get":{"tags":["Calibrations"],"summary":"Get calibration detail","description":"Retrieve one calibration record, including participants, aggregate scoring, and per-evaluator submission status.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `qm_calibrations:read`,`qm_calibrations:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_quality_management:read:calibrations`,`zoom_quality_management:read:calibrations:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"GetCalibrationDetail","parameters":[{"name":"calibrationId","in":"path","description":"The calibration task ID.","required":true,"schema":{"type":"string","example":"0e73a69f8f104d24a589fa0c615abca8"}}],"responses":{"200":{"description":"Successfully retrieved the calibration detail.","content":{"application/json":{"schema":{"type":"object","properties":{"calibration_id":{"type":"string","description":"The calibration task ID.","example":"0e73a69f8f104d24a589fa0c615abca8"},"account_id":{"type":"string","description":"The account ID.","example":"SY-AEWW6Ruqgt89_T2zqBg"},"task_name":{"type":"string","description":"The calibration task name.","example":"calibration_q9DyYF8iSXa3PVAhb6nekQ"},"status":{"type":"string","description":"The calibration's current status.","example":"Active","enum":["Active","Completed","Expired","Canceled"]},"channel_type":{"type":"string","description":"The interaction's channel type.","example":"VIDEO","enum":["VIDEO","AUDIO","MANUAL","MESSAGE"]},"division_id":{"type":"string","description":"The division ID associated with the calibration task.","example":"div_123"},"interaction_id":{"type":"string","description":"The interaction ID.","example":"q9DyYF8iSXa3PVAhb6nekQ"},"scorecard_id":{"type":"string","description":"The calibration scorecard ID.","example":"2uJ4u83yQ_qbyyFDmxsMcQ"},"scorecard_name":{"type":"string","description":"The calibration scorecard name.","example":"Customer Care"},"minimum_evaluators":{"type":"integer","description":"The minimum number of evaluator submissions required to complete the calibration.","example":100},"due_date":{"type":"string","description":"The calibration due date, in `yyyy-MM-dd'T'HH:mm:ss'Z'` format.","example":"2026-08-05T10:45:00Z"},"create_time":{"type":"string","description":"The date when the calibration was created, in `yyyy-MM-dd'T'HH:mm:ss'Z'` format.","example":"2026-07-20T09:52:22Z"},"modify_time":{"type":"string","description":"The date when the calibration was last modified, in `yyyy-MM-dd'T'HH:mm:ss'Z'` format.","example":"2026-07-28T09:52:22Z"},"creator_info":{"type":"object","properties":{"user_id":{"type":"string","description":"The calibration creator's Zoom user ID.","example":"b0_yDuNGSq65EF8i1f0PcQ"},"display_name":{"type":"string","description":"The calibration creator's display name.","example":"Rick Arps"}},"description":"The calibration creator's information."},"agent_info":{"type":"object","properties":{"user_id":{"type":"string","description":"The agent's user ID.","example":"httgPnTgTxq0d65-alfYVw"},"display_name":{"type":"string","description":"The agent's display name.","example":"Ashlee York"}},"description":"The agent's information."},"evaluators_info":{"type":"array","description":"The evaluators' information.","items":{"type":"object","properties":{"user_id":{"type":"string","description":"The evaluator's user ID.","example":"b0_yDuNGSq65EF8i1f0PcQ"},"display_name":{"type":"string","description":"The evaluator's display name.","example":"Rick Arps"}}}},"scoring_format":{"type":"string","description":"The scorecard's scoring format.","example":"percentage","enum":["points","percentage"]},"total_score":{"type":"number","description":"The total score on the scorecard.","example":50},"evaluation_score":{"type":"number","description":"The sibling manual evaluation score for the same interaction.","example":42},"calibration_score":{"type":"number","description":"The average score across completed evaluator submissions for the calibration.","example":40},"calibration_complete_percentage":{"type":"number","description":"The percentage of assigned evaluators who have submitted the calibration.","example":0.66},"interaction_deleted":{"type":"boolean","description":"Whether the interaction was deleted.","example":false},"completion_date":{"type":"string","description":"The date when the calibration was completed, in `yyyy-MM-dd'T'HH:mm:ss'Z'` format.","example":"2026-03-16T10:45:00Z"},"evaluator_submissions":{"type":"array","description":"The evaluator submission statuses for this calibration.","items":{"type":"object","properties":{"evaluator":{"type":"object","properties":{"user_id":{"type":"string","description":"The evaluator's Zoom user ID.","example":"b0_yDuNGSq65EF8i1f0PcQ"},"display_name":{"type":"string","description":"The evaluator's display name.","example":"Rick Arps"}},"description":"The evaluator's information."},"status":{"type":"string","description":"The evaluator's submission status.","example":"completed","enum":["pending","in_progress","completed"]},"submitted_at":{"type":"string","description":"The date when the evaluator submitted the calibration, in `yyyy-MM-dd'T'HH:mm:ss'Z'` format.","nullable":true,"example":"2026-07-28T10:10:00Z"},"score":{"type":"number","description":"The evaluator's submitted calibration score.","nullable":true,"example":41}}}},"calibration_result":{"type":"array","description":"Question-level comparison results for the calibration.","items":{"type":"object","properties":{"section":{"type":"string","description":"The scorecard section name.","example":"Greeting"},"max_score":{"type":"number","description":"The maximum score for the section.","example":10},"question_list":{"type":"array","description":"The questions in this section.","items":{"type":"object","properties":{"title":{"type":"string","description":"The question title.","example":"Used proper opening"},"description":{"type":"string","description":"The question description.","example":"Started the interaction with the required opening statement."},"max_score":{"type":"number","description":"The maximum score for the question.","example":5},"total_score":{"type":"number","description":"The overall score for the question after aggregation.","example":5},"evaluators":{"type":"array","description":"The evaluator-level responses for the question.","items":{"type":"object","properties":{"score":{"type":"number","description":"The evaluator's score for the question.","example":5},"name":{"type":"string","description":"The evaluator's display name.","example":"Manager One"},"comment":{"type":"string","description":"The evaluator's comment for the question.","example":"Good opening and tone."},"answer":{"type":"string","description":"The evaluator's answer for the question.","example":"Yes"}}}}}}}}}}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  Bad request.\n\n "},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  Unauthorized.\n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  Calibration not found.\n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_authorization":[]}],"x-extensions":{"x-permissions":["InteractionPerformanceMgt:Read","AssignEvaluations:Edit","AllInteractions:Read"],"x-macro-scopes":["qm_calibrations:read","qm_calibrations:read:admin"],"x-granular-scopes":["zoom_quality_management:read:calibrations","zoom_quality_management:read:calibrations:admin"]}}},"/qm/cases":{"get":{"tags":["Cases"],"summary":"List cases","description":"Returns cases visible to the authenticated caller.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `qm_cases:read`,`qm_cases:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_quality_management:read:cases`,`zoom_quality_management:read:cases:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"listCases","parameters":[{"name":"page_size","in":"query","description":"The page size request parameter.","required":false,"schema":{"maximum":100,"minimum":1,"type":"integer","description":"The page size value.","example":1,"default":30}},{"name":"next_page_token","in":"query","description":"The next page token request parameter.","required":false,"schema":{"type":"string","description":"The next page token value.","example":"example-value"}},{"name":"filter","in":"query","description":"The case ownership filter.","required":false,"schema":{"type":"string","description":"The filter value.","example":"myCases","default":"allCases","enum":["myCases","allCases"]}},{"name":"from","in":"query","description":"The lower bound for the source case creation time as an ISO-8601 UTC date-time.","required":false,"schema":{"type":"string","description":"The from value.","format":"date-time","example":"2026-01-15T10:30:00Z"}},{"name":"to","in":"query","description":"The upper bound for the source case creation time as an ISO-8601 UTC date-time.","required":false,"schema":{"type":"string","description":"The to value.","format":"date-time","example":"2026-01-15T10:30:00Z"}},{"name":"agent_id","in":"query","description":"The agent ID request parameter.","required":false,"schema":{"maxLength":255,"type":"string","description":"The agent ID value.","example":"example-value"}},{"name":"status","in":"query","description":"The status request parameter.","required":false,"schema":{"maxLength":255,"type":"string","description":"The status value.","example":"example-value"}},{"name":"priority","in":"query","description":"The priority request parameter.","required":false,"schema":{"maxLength":255,"type":"string","description":"The priority value.","example":"example-value"}},{"name":"source_case_id","in":"query","description":"The source case ID request parameter.","required":false,"schema":{"maxLength":255,"type":"string","description":"The source case ID value.","example":"example-value"}},{"name":"connection_id","in":"query","description":"The connection ID request parameter.","required":false,"schema":{"maxLength":255,"type":"string","description":"The connection ID value.","example":"example-value"}},{"name":"sort_by","in":"query","description":"The sort by request parameter.","required":false,"schema":{"type":"string","description":"The sort by value.","example":"created_at","enum":["created_at","creating_time","last_source_updated_at","status","priority","assignee","updated_at"]}},{"name":"sort_order","in":"query","description":"The sort order request parameter.","required":false,"schema":{"type":"string","description":"The sort order value.","example":"asc","enum":["asc","desc"]}}],"responses":{"200":{"description":"Cases returned successfully.","content":{"application/json":{"schema":{"required":["data","page_size","total"],"type":"object","properties":{"total":{"minimum":0,"type":"integer","description":"The total number of records.","format":"int64","example":1},"page_size":{"maximum":100,"minimum":1,"type":"integer","description":"The number of records returned per page.","example":1},"next_page_token":{"type":"string","description":"The token used to retrieve the next page of results.","nullable":true,"example":"example-value"},"data":{"type":"array","description":"The list of case records.","example":[],"items":{"required":["qm_case_id"],"type":"object","properties":{"account_id":{"type":"string","description":"The account ID.","example":"example-value"},"division_id":{"type":"string","description":"The division ID.","example":"example-value"},"connection_id":{"type":"string","description":"The connection ID.","example":"example-value"},"qm_case_id":{"type":"string","description":"The quality management case ID.","example":"example-value"},"external_case_key":{"type":"string","description":"The external case key.","example":"example-value"},"source_case_id":{"type":"string","description":"The source case ID.","example":"example-value"},"schema_version":{"type":"string","description":"The schema version.","example":"example-value"},"last_source_updated_at":{"type":"string","description":"The timestamp when the source was last updated.","format":"date-time","example":"2026-01-15T10:30:00Z"},"last_idempotency_key":{"type":"string","description":"The last idempotency key.","example":"example-value"},"mapped_fields":{"type":"object","additionalProperties":true,"description":"The mapped fields value.","example":{}},"derived_engagement_ids":{"type":"array","description":"The derived engagement IDs.","example":[],"items":{"type":"string"}},"indicators":{"type":"array","description":"Case-level indicator summaries.","example":[{"indicator_id":"indicator-123","indicator_name":"Customer sentiment","matched_activity_count":2}],"items":{"type":"object","properties":{"indicator_id":{"type":"string","description":"The case-level indicator identifier.","example":"indicator-123"},"indicator_name":{"type":"string","description":"The case-level indicator name.","example":"Customer sentiment"},"matched_activity_count":{"minimum":0,"type":"integer","description":"The number of activities matched by the indicator.","format":"int32","example":2}},"additionalProperties":false}},"topics":{"type":"array","description":"Case-level topic summaries.","example":[{"topic_id":"topic-123","topic":"Billing inquiry","type":"predefined","matched_activity_ids":["activity-123"],"matched_activity_count":1}],"items":{"type":"object","properties":{"topic_id":{"type":"string","description":"The case-level topic identifier.","example":"topic-123"},"topic":{"type":"string","description":"The case-level topic text.","example":"Billing inquiry"},"type":{"type":"string","description":"The topic classification type.","example":"predefined"},"matched_activity_ids":{"type":"array","description":"The activity identifiers matched to the topic.","example":["activity-123"],"items":{"type":"string","description":"The matched activity identifier.","example":"activity-123"}},"matched_activity_count":{"minimum":0,"type":"integer","description":"The number of activities matched to the topic.","format":"int32","example":1}},"additionalProperties":false}},"create_time":{"type":"string","description":"The time when the case was created.","format":"date-time","example":"2026-01-15T10:30:00Z"},"modify_time":{"type":"string","description":"The time when the case was last modified.","format":"date-time","example":"2026-01-15T10:30:00Z"}},"additionalProperties":false}}},"additionalProperties":false}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  The request is invalid or malformed.\n\n "},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  The request lacks valid authentication credentials.\n\n "},"403":{"description":"**HTTP Status Code:** `403` <br>\n Forbidden  The caller is authenticated but does not have the required case-read scopes.\n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "},"500":{"description":"**HTTP Status Code:** `500` <br>\n Internal Server Error  An unexpected server-side failure occurred.\n\n "}},"security":[{"openapi_authorization":[]}],"x-extensions":{"x-permissions":["AllInteractions:Read","InteractionPerformanceMgt:Read"],"x-macro-scopes":["qm_cases:read","qm_cases:read:admin"],"x-granular-scopes":["zoom_quality_management:read:cases","zoom_quality_management:read:cases:admin"]}}},"/qm/cases/{qmCaseId}":{"get":{"tags":["Cases"],"summary":"Get case details","description":"Returns the base case plus default AI summary, AI sentiment, and performance information. Activities, interactions, and activity level sentiment are opt-in includes.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `qm_cases:read`,`qm_cases:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_quality_management:read:cases`,`zoom_quality_management:read:cases:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"getCaseDetails","parameters":[{"name":"qmCaseId","in":"path","description":"Quality management case identifier.","required":true,"schema":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$","type":"string","description":"The QM case ID.","example":"example-value"}},{"name":"include","in":"query","description":"Optional comma-separated nested blocks. Allowed values are activities, interactions, and ai_sentiment_activities.","required":false,"schema":{"uniqueItems":true,"type":"array","description":"The include.","example":[],"items":{"type":"string","enum":["activities","interactions","ai_sentiment_activities"]}},"example":"activities,interactions"}],"responses":{"200":{"description":"One case.","content":{"application/json":{"schema":{"required":["qm_case_id"],"type":"object","properties":{"account_id":{"type":"string","description":"The account ID.","example":"example-value"},"division_id":{"type":"string","description":"The division ID.","example":"example-value"},"connection_id":{"type":"string","description":"The connection ID.","example":"example-value"},"qm_case_id":{"type":"string","description":"The QM case ID.","example":"example-value"},"external_case_key":{"type":"string","description":"The external case key.","example":"example-value"},"source_case_id":{"type":"string","description":"The source case ID.","example":"example-value"},"schema_version":{"type":"string","description":"The schema version.","example":"example-value"},"last_source_updated_at":{"type":"string","description":"The last source updated at value.","format":"date-time","example":"2026-01-15T10:30:00Z"},"last_idempotency_key":{"type":"string","description":"The last idempotency key.","example":"example-value"},"mapped_fields":{"type":"object","additionalProperties":true,"description":"Map of dynamically named source-field mappings.","example":{}},"derived_engagement_ids":{"type":"array","description":"The derived engagement ID's.","example":[],"items":{"type":"string"}},"indicators":{"type":"array","description":"The indicators.","example":[],"items":{"type":"object","properties":{"indicator_id":{"type":"string","description":"The indicator ID.","example":"example-value"},"indicator_name":{"type":"string","description":"The indicator name.","example":"example-value"},"matched_activity_count":{"minimum":0,"type":"integer","description":"The matched activity count.","format":"int32","example":1}},"additionalProperties":false}},"topics":{"type":"array","description":"The topics.","example":[],"items":{"type":"object","properties":{"topic_id":{"type":"string","description":"The topic ID.","example":"example-value"},"topic":{"type":"string","description":"The topic.","example":"example-value"},"type":{"type":"string","description":"The type.","example":"example-value"},"matched_activity_ids":{"type":"array","description":"The matched activity ID's.","example":[],"items":{"type":"string"}},"matched_activity_count":{"minimum":0,"type":"integer","description":"The matched activity count.","format":"int32","example":1}},"additionalProperties":false}},"create_time":{"type":"string","description":"The create time.","format":"date-time","example":"2026-01-15T10:30:00Z"},"modify_time":{"type":"string","description":"The modify time.","format":"date-time","example":"2026-01-15T10:30:00Z"},"activities":{"required":["items"],"type":"object","properties":{"items":{"type":"array","description":"The items.","example":[],"items":{"type":"object","properties":{"item_kind":{"type":"string","description":"The item kind.","example":"example-value"},"item_type":{"type":"string","description":"The item type.","example":"example-value"},"created_at":{"type":"string","description":"The created at value.","format":"date-time","example":"2026-01-15T10:30:00Z"},"activity":{"type":"object","properties":{"source_activity_id":{"type":"string","description":"The source activity ID.","example":"example-value"},"activity_type":{"type":"string","description":"The activity type.","example":"example-value"},"visibility":{"type":"string","description":"The visibility.","example":"example-value"},"author_name":{"type":"string","description":"The author name.","example":"example-value"},"author_email":{"type":"string","description":"The author email.","format":"email","example":"agent@example.com"},"body_text":{"type":"string","description":"The body text.","example":"example-value"},"email_info":{"type":"object","properties":{"subject":{"type":"string","description":"Email subject.","example":"Follow up on your request"},"body_text":{"type":"string","description":"Plain text email body.","example":"Thank you for contacting us."},"sent_at":{"type":"string","description":"Source provided email sent timestamp.","example":"2026-01-15T10:30:00Z"},"received_at":{"type":"string","description":"Source provided email received timestamp.","example":"2026-01-15T10:31:00Z"},"direction":{"type":"string","description":"Email direction.","example":"outbound"},"from":{"type":"string","description":"Email sender address.","example":"agent@example.com"},"to":{"type":"array","description":"Email recipient addresses.","example":["customer@example.com"],"items":{"type":"string"}},"cc":{"type":"array","description":"Email carbon-copy recipient addresses.","example":[],"items":{"type":"string"}}},"additionalProperties":false,"description":"Email metadata attached to a case activity.","example":{"subject":"Follow up on your request","direction":"outbound","to":["customer@example.com"]}},"field_change_info":{"type":"object","properties":{"field_name":{"type":"string","description":"Changed source field name.","example":"status"},"old_value":{"type":"string","description":"Previous field.","example":"Open"},"old_value_id":{"type":"string","description":"Previous field identifier.","example":"open"},"old_value_email":{"type":"string","description":"Previous field email address.","example":"previous@example.com"},"new_value":{"type":"string","description":"New field.","example":"Closed"},"new_value_id":{"type":"string","description":"New field identifier.","example":"closed"},"new_value_email":{"type":"string","description":"New field email address.","example":"current@example.com"},"source_table":{"type":"string","description":"Source system table name.","example":"case"},"document_key":{"type":"string","description":"Source system document key.","example":"case-123"}},"additionalProperties":false,"description":"Source field change metadata attached to a case activity.","example":{"field_name":"status","old_value":"Open","new_value":"Closed"}},"attachment_refs":{"type":"array","description":"The attachment refs.","example":[],"items":{"type":"object","properties":{"source_attachment_id":{"type":"string","description":"Source system attachment identifier.","example":"attachment-123"},"zfs_file_id":{"type":"string","description":"Zoom file storage identifier.","example":"zfs-file-123"},"file_name":{"type":"string","description":"Attachment file name.","example":"invoice.pdf"},"content_type":{"type":"string","description":"Attachment media type.","example":"application/pdf"},"size_bytes":{"type":"integer","description":"Attachment size in bytes.","format":"int64","example":1024},"user_info":{"type":"object","additionalProperties":true,"description":"Attachment user information beyond the supported schema depth.","example":{}},"download_url":{"type":"string","description":"Authorized attachment download URL.","example":"https://example.com/attachments/attachment-123"}},"additionalProperties":false,"description":"Attachment reference attached to a case activity.","example":{"source_attachment_id":"attachment-123","file_name":"invoice.pdf","size_bytes":1024}}},"indicator_matches":{"type":"array","description":"The indicator matches.","example":[],"items":{"type":"object","properties":{"indicator_id":{"type":"string","description":"Indicator identifier.","example":"indicator 123"},"indicator_name":{"type":"string","description":"Indicator name.","example":"Customer sentiment"},"matched_keyword":{"type":"string","description":"Matched keyword.","example":"refund"},"matched_field":{"type":"string","description":"Activity field containing the match.","example":"body_text"},"span":{"type":"array","description":"Start and end offsets of the matched text.","example":[12,18],"items":{"type":"integer","format":"int32"}}},"additionalProperties":false,"description":"Derived indicator-match metadata for a case activity.","example":{"indicator_id":"indicator-123","matched_keyword":"refund","span":[12,18]}}}},"additionalProperties":false,"description":"The activity.","example":{}},"interaction":{"type":"object","properties":{"interaction_id":{"type":"string","description":"The interaction ID.","example":"example-value"},"channel_type":{"type":"string","description":"The channel type.","example":"example-value"},"created_at":{"type":"string","description":"The created at value.","format":"date-time","example":"2026-01-15T10:30:00Z"}},"additionalProperties":false,"description":"The interaction.","example":{}}},"additionalProperties":false}}},"additionalProperties":false,"description":"Returned only when `activities` is included. Items are ordered newest first and are not paginated.","example":{}},"interactions":{"type":"array","description":"Returned only when `interactions` is included. The complete authorized interaction set is returned without pagination.","example":[],"items":{"type":"object","properties":{"start_time":{"type":"string","description":"The start time value.","format":"date-time","example":"2026-01-15T10:30:00Z"},"duration":{"type":"integer","description":"The duration.","format":"int32","example":1},"queue_id":{"type":"string","description":"The queue ID.","example":"example-value"},"queue_name":{"type":"string","description":"The queue name.","example":"example-value"},"engagement_id":{"type":"string","description":"The engagement ID.","example":"example-value"},"direction":{"type":"string","description":"The direction.","example":"example-value"},"disposition":{"type":"string","description":"The disposition.","example":"example-value"},"silence_event_count":{"type":"integer","description":"The silence event count.","format":"int32","example":1},"crosstalk_event_count":{"type":"integer","description":"The crosstalk event count.","format":"int32","example":1},"hold_event_count":{"type":"integer","description":"The hold event count.","format":"int32","example":1},"scorecard_name":{"type":"string","description":"The scorecard name.","example":"example-value"},"language":{"type":"string","description":"The language.","example":"example-value"},"interaction_info":{"type":"object","properties":{"interaction_id":{"type":"string","description":"Interaction identifier.","example":"interaction-123"},"agent_name":{"type":"string","description":"Agent display name.","example":"Alex Smith"},"from":{"type":"string","description":"Interaction origin.","example":"+15551234567"},"to":{"type":"string","description":"Interaction destination.","example":"+15557654321"},"consumer_name":{"type":"string","description":"Consumer display name.","example":"Taylor Jones"},"channel_type":{"type":"string","description":"Interaction channel type.","example":"voice"},"evaluations":{"type":"array","description":"Interaction evaluation records.","example":[],"items":{"type":"object","properties":{"evaluation_id":{"type":"string","description":"Evaluation identifier.","example":"evaluation-123"},"evaluation_type":{"type":"string","description":"Evaluation type.","example":"MANUAL","enum":["MANUAL","AUTOMATED"]},"evaluation_name":{"type":"string","description":"Evaluation name.","example":"Customer service review"},"evaluation_status":{"type":"integer","description":"Numeric evaluation status. Values:\n\n- 0 Active\n- 1 Completed\n- 2 Pending\n- 3 Expired\n- 4 Canceled.","format":"int32","example":2,"enum":[0,1,2,3,4]},"evaluation_status_desc":{"type":"string","description":"Evaluation status description.","example":"COMPLETED"},"session_id":{"type":"string","description":"Evaluation session identifier.","example":"session-123"},"score":{"type":"number","description":"Evaluation score.","example":85},"total_score":{"type":"number","description":"Total available score.","example":100},"score_rate":{"type":"number","description":"Normalized score rate.","example":0.85},"score_percent_formatted":{"type":"string","description":"Formatted score percentage.","example":"85%"},"scoring_format":{"type":"string","description":"Scoring format.","example":"percentage"},"section_comments":{"type":"array","description":"Section comments beyond level 4.","example":[],"items":{"type":"object","additionalProperties":true}},"question_comments":{"type":"array","description":"Question comments beyond level 4.","example":[],"items":{"type":"object","additionalProperties":true}},"evaluator_id":{"type":"string","description":"Evaluator identifier.","example":"user-123"},"evaluator_name":{"type":"string","description":"Evaluator display name.","example":"Alex Smith"}},"additionalProperties":false,"description":"Quality management evaluation associated with an interaction.","example":{"evaluation_id":"evaluation-123","evaluation_type":"MANUAL","score":85}}}},"additionalProperties":false,"description":"Public interaction identity and participant information. Only fields copied by `QmOpenAPIMeetingVO` are included.","example":{"interaction_id":"interaction-123","agent_name":"Alex Smith","channel_type":"voice"}},"summary":{"type":"object","properties":{"evaluation_score":{"type":"number","description":"Evaluation score.","example":85},"engagement_score":{"type":"number","description":"Engagement score.","example":80},"sentiment_score":{"type":"number","description":"Sentiment score.","example":0.8},"sentiment_score_reason":{"type":"string","description":"Reason for the sentiment score.","example":"Mostly positive interaction."}},"additionalProperties":false,"description":"Public interaction score summary. Only fields copied by `QmOpenAPIMeetingVO` are included.","example":{"evaluation_score":85,"engagement_score":80,"sentiment_score":0.8}},"transcript_body":{"type":"object","additionalProperties":true,"description":"Interaction transcript metadata and content. Speakers and transcript items are intentionally open beyond the supported schema depth.","example":{"recording_id":"recording-123","primary_language":"en","transcript_num":1}},"metrics":{"type":"object","properties":{"talk_to_listen_ratio":{"type":"array","description":"Talk to listen metric buckets.","example":[],"items":{"type":"object","properties":{"id":{"type":"string","description":"Metric bucket identifier.","example":"agent"},"value":{"type":"number","description":"Metric bucket.","example":0.75}},"additionalProperties":false,"description":"Named interaction metric bucket.","example":{"id":"agent","value":0.75}}},"longest_monolog":{"type":"array","description":"Longest monologue metric buckets.","example":[],"items":{"type":"object","properties":{"id":{"type":"string","description":"Metric bucket identifier.","example":"agent"},"value":{"type":"number","description":"Metric bucket.","example":0.75}},"additionalProperties":false,"description":"Named interaction metric bucket.","example":{"id":"agent","value":0.75}}},"talk_speed":{"type":"array","description":"Talk speed metric buckets.","example":[],"items":{"type":"object","properties":{"id":{"type":"string","description":"Metric bucket identifier.","example":"agent"},"value":{"type":"number","description":"Metric bucket.","example":0.75}},"additionalProperties":false,"description":"Named interaction metric bucket.","example":{"id":"agent","value":0.75}}},"filler_words":{"type":"array","description":"Filler word metric buckets.","example":[],"items":{"type":"object","properties":{"id":{"type":"string","description":"Metric bucket identifier.","example":"agent"},"value":{"type":"number","description":"Metric bucket.","example":0.75}},"additionalProperties":false,"description":"Named interaction metric bucket.","example":{"id":"agent","value":0.75}}},"patience":{"type":"array","description":"Patience metric buckets.","example":[],"items":{"type":"object","properties":{"id":{"type":"string","description":"Metric bucket identifier.","example":"agent"},"value":{"type":"number","description":"Metric bucket.","example":0.75}},"additionalProperties":false,"description":"Named interaction metric bucket.","example":{"id":"agent","value":0.75}}},"time_on_slides":{"type":"array","description":"Time on slides metric buckets.","example":[],"items":{"type":"object","properties":{"id":{"type":"string","description":"Metric bucket identifier.","example":"agent"},"value":{"type":"number","description":"Metric bucket.","example":0.75}},"additionalProperties":false,"description":"Named interaction metric bucket.","example":{"id":"agent","value":0.75}}},"engaging_questions":{"type":"array","description":"Engaging question metric buckets.","example":[],"items":{"type":"object","properties":{"id":{"type":"string","description":"Metric bucket identifier.","example":"agent"},"value":{"type":"number","description":"Metric bucket.","example":0.75}},"additionalProperties":false,"description":"Named interaction metric bucket.","example":{"id":"agent","value":0.75}}}},"additionalProperties":false,"description":"Interaction metrics. Metric buckets are intentionally open beyond the supported schema depth.","example":{"talk_to_listen_ratio":[]}},"analysis_v2":{"type":"object","properties":{"format_version":{"type":"string","description":"Analysis format version.","example":"2.0"},"next_steps":{"type":"array","description":"Next step analysis records.","example":[],"items":{"type":"object","properties":{"section":{"type":"array","description":"Analysis items beyond level 4.","example":[],"items":{"type":"object","additionalProperties":true}}},"additionalProperties":false,"description":"Version 2 analysis section.","example":{"section":[]}}},"engaging_questions":{"type":"array","description":"Engaging question analysis records.","example":[],"items":{"type":"object","properties":{"section":{"type":"array","description":"Analysis items beyond level 4.","example":[],"items":{"type":"object","additionalProperties":true}}},"additionalProperties":false,"description":"Version 2 analysis section.","example":{"section":[]}}},"filler_words":{"type":"array","description":"Filler word analysis records.","example":[],"items":{"type":"object","properties":{"id":{"type":"integer","description":"Analysis item identifier.","format":"int32","example":1},"text":{"type":"string","description":"Analysis item text.","example":"Customer requested a refund."},"utterance":{"type":"string","description":"Source utterance.","example":"I would like a refund."},"span":{"type":"array","description":"Text span offsets.","example":[0,22],"items":{"type":"integer","format":"int32"}},"username":{"type":"string","description":"Speaker username.","example":"Alex Smith"},"zm_user_id":{"type":"string","description":"Zoom user identifier.","example":"user-123"},"user_id":{"type":"string","description":"User identifier.","example":"user-123"},"item_id_span":{"type":"array","description":"Transcript item span.","example":[1,2],"items":{"type":"integer","format":"int32"}},"label":{"type":"string","description":"Analysis label.","example":"refund"},"category":{"type":"string","description":"Analysis category.","example":"sentiment"},"id_start":{"type":"integer","description":"Start item identifier.","format":"int32","example":1},"id_end":{"type":"integer","description":"End item identifier.","format":"int32","example":2},"score":{"type":"number","description":"Analysis score.","example":0.8},"start_time":{"type":"string","description":"Analysis start time.","example":"00:01:02.000"},"end_time":{"type":"string","description":"Analysis end time.","example":"00:01:05.500"},"wait_sec":{"type":"number","description":"Wait duration in seconds.","example":2.5}},"additionalProperties":false,"description":"Version 2 analysis item.","example":{"id":1,"label":"refund","score":0.8}}},"risks":{"type":"array","description":"Risk analysis records.","example":[],"items":{"type":"object","properties":{"id":{"type":"integer","description":"Analysis item identifier.","format":"int32","example":1},"text":{"type":"string","description":"Analysis item text.","example":"Customer requested a refund."},"utterance":{"type":"string","description":"Source utterance.","example":"I would like a refund."},"span":{"type":"array","description":"Text span offsets.","example":[0,22],"items":{"type":"integer","format":"int32"}},"username":{"type":"string","description":"Speaker username.","example":"Alex Smith"},"zm_user_id":{"type":"string","description":"Zoom user identifier.","example":"user-123"},"user_id":{"type":"string","description":"User identifier.","example":"user-123"},"item_id_span":{"type":"array","description":"Transcript item span.","example":[1,2],"items":{"type":"integer","format":"int32"}},"label":{"type":"string","description":"Analysis label.","example":"refund"},"category":{"type":"string","description":"Analysis category.","example":"sentiment"},"id_start":{"type":"integer","description":"Start item identifier.","format":"int32","example":1},"id_end":{"type":"integer","description":"End item identifier.","format":"int32","example":2},"score":{"type":"number","description":"Analysis score.","example":0.8},"start_time":{"type":"string","description":"Analysis start time.","example":"00:01:02.000"},"end_time":{"type":"string","description":"Analysis end time.","example":"00:01:05.500"},"wait_sec":{"type":"number","description":"Wait duration in seconds.","example":2.5}},"additionalProperties":false,"description":"Version 2 analysis item.","example":{"id":1,"label":"refund","score":0.8}}},"linear_paths":{"type":"object","properties":{"meeting_id":{"type":"string","description":"Meeting identifier.","example":"meeting-123"},"items":{"type":"array","description":"Linear path items beyond level 4.","example":[],"items":{"type":"object","additionalProperties":true}},"overall_summary":{"type":"string","description":"Overall interaction summary.","example":"The interaction resolved the billing request."},"brief_template_id":{"type":"string","description":"Brief template identifier.","example":"template-123"},"custom_brief_prompt":{"type":"string","description":"Custom brief prompt.","example":"Summarize the interaction."},"deal_memo":{"type":"object","additionalProperties":true,"description":"Deal memo beyond level 4.","example":{}}},"additionalProperties":false,"description":"Interaction linear path analysis.","example":{"meeting_id":"meeting-123","overall_summary":"The interaction resolved the billing request."}},"patience":{"type":"array","description":"Patience analysis records.","example":[],"items":{"type":"object","properties":{"id":{"type":"integer","description":"Analysis item identifier.","format":"int32","example":1},"text":{"type":"string","description":"Analysis item text.","example":"Customer requested a refund."},"utterance":{"type":"string","description":"Source utterance.","example":"I would like a refund."},"span":{"type":"array","description":"Text span offsets.","example":[0,22],"items":{"type":"integer","format":"int32"}},"username":{"type":"string","description":"Speaker username.","example":"Alex Smith"},"zm_user_id":{"type":"string","description":"Zoom user identifier.","example":"user-123"},"user_id":{"type":"string","description":"User identifier.","example":"user-123"},"item_id_span":{"type":"array","description":"Transcript item span.","example":[1,2],"items":{"type":"integer","format":"int32"}},"label":{"type":"string","description":"Analysis label.","example":"refund"},"category":{"type":"string","description":"Analysis category.","example":"sentiment"},"id_start":{"type":"integer","description":"Start item identifier.","format":"int32","example":1},"id_end":{"type":"integer","description":"End item identifier.","format":"int32","example":2},"score":{"type":"number","description":"Analysis score.","example":0.8},"start_time":{"type":"string","description":"Analysis start time.","example":"00:01:02.000"},"end_time":{"type":"string","description":"Analysis end time.","example":"00:01:05.500"},"wait_sec":{"type":"number","description":"Wait duration in seconds.","example":2.5}},"additionalProperties":false,"description":"Version 2 analysis item.","example":{"id":1,"label":"refund","score":0.8}}},"indicators":{"type":"array","description":"Indicator analysis records.","example":[],"items":{"type":"object","properties":{"section":{"type":"array","description":"Indicator analysis items beyond level 4.","example":[],"items":{"type":"object","additionalProperties":true}}},"additionalProperties":false,"description":"Indicator analysis section.","example":{"section":[]}}},"engagement":{"type":"array","description":"Engagement analysis records.","example":[],"items":{"type":"object","properties":{"id":{"type":"integer","description":"Analysis item identifier.","format":"int32","example":1},"text":{"type":"string","description":"Analysis item text.","example":"Customer requested a refund."},"utterance":{"type":"string","description":"Source utterance.","example":"I would like a refund."},"span":{"type":"array","description":"Text span offsets.","example":[0,22],"items":{"type":"integer","format":"int32"}},"username":{"type":"string","description":"Speaker username.","example":"Alex Smith"},"zm_user_id":{"type":"string","description":"Zoom user identifier.","example":"user-123"},"user_id":{"type":"string","description":"User identifier.","example":"user-123"},"item_id_span":{"type":"array","description":"Transcript item span.","example":[1,2],"items":{"type":"integer","format":"int32"}},"label":{"type":"string","description":"Analysis label.","example":"refund"},"category":{"type":"string","description":"Analysis category.","example":"sentiment"},"id_start":{"type":"integer","description":"Start item identifier.","format":"int32","example":1},"id_end":{"type":"integer","description":"End item identifier.","format":"int32","example":2},"score":{"type":"number","description":"Analysis score.","example":0.8},"start_time":{"type":"string","description":"Analysis start time.","example":"00:01:02.000"},"end_time":{"type":"string","description":"Analysis end time.","example":"00:01:05.500"},"wait_sec":{"type":"number","description":"Wait duration in seconds.","example":2.5}},"additionalProperties":false,"description":"Version 2 analysis item.","example":{"id":1,"label":"refund","score":0.8}}},"sentiment":{"type":"array","description":"Sentiment analysis records.","example":[],"items":{"type":"object","properties":{"id":{"type":"integer","description":"Analysis item identifier.","format":"int32","example":1},"text":{"type":"string","description":"Analysis item text.","example":"Customer requested a refund."},"utterance":{"type":"string","description":"Source utterance.","example":"I would like a refund."},"span":{"type":"array","description":"Text span offsets.","example":[0,22],"items":{"type":"integer","format":"int32"}},"username":{"type":"string","description":"Speaker username.","example":"Alex Smith"},"zm_user_id":{"type":"string","description":"Zoom user identifier.","example":"user-123"},"user_id":{"type":"string","description":"User identifier.","example":"user-123"},"item_id_span":{"type":"array","description":"Transcript item span.","example":[1,2],"items":{"type":"integer","format":"int32"}},"label":{"type":"string","description":"Analysis label.","example":"refund"},"category":{"type":"string","description":"Analysis category.","example":"sentiment"},"id_start":{"type":"integer","description":"Start item identifier.","format":"int32","example":1},"id_end":{"type":"integer","description":"End item identifier.","format":"int32","example":2},"score":{"type":"number","description":"Analysis score.","example":0.8},"start_time":{"type":"string","description":"Analysis start time.","example":"00:01:02.000"},"end_time":{"type":"string","description":"Analysis end time.","example":"00:01:05.500"},"wait_sec":{"type":"number","description":"Wait duration in seconds.","example":2.5}},"additionalProperties":false,"description":"Version 2 analysis item.","example":{"id":1,"label":"refund","score":0.8}}},"topics":{"type":"array","description":"Topic analysis records.","example":[],"items":{"type":"object","properties":{"section":{"type":"array","description":"Analysis items beyond level 4.","example":[],"items":{"type":"object","additionalProperties":true}}},"additionalProperties":false,"description":"Version 2 analysis section.","example":{"section":[]}}},"topic_mentioned_v2":{"type":"string","description":"Version 2 topic mention text.","example":"Billing"},"aic_topic":{"type":"array","description":"AI Companion topic records.","example":[],"items":{"type":"object","properties":{"topic":{"type":"string","description":"Topic text.","example":"Billing"},"item_id_span":{"type":"array","description":"Transcript item span for the topic.","example":[1,2],"items":{"type":"integer","format":"int32"}}},"additionalProperties":false,"description":"AI Companion topic.","example":{"topic":"Billing","item_id_span":[1,2]}}},"analysis_num":{"type":"integer","description":"Analysis sequence number.","format":"int32","example":1},"playbooks":{"type":"array","description":"Playbook analysis records.","example":[],"items":{"type":"object","properties":{"playbook_id":{"type":"string","description":"Playbook identifier.","example":"playbook-123"},"playbook_name":{"type":"string","description":"Playbook name.","example":"Retention playbook"},"elements":{"type":"array","description":"Playbook elements beyond level 4.","example":[],"items":{"type":"object","additionalProperties":true}}},"additionalProperties":false,"description":"Interaction analysis playbook.","example":{"playbook_id":"playbook-123","playbook_name":"Retention playbook"}}},"qm_ai_topics":{"type":"array","description":"QM AI topic records.","example":[],"items":{"type":"object","properties":{"id":{"type":"string","description":"Topic identifier.","example":"topic-123"},"topic":{"type":"string","description":"Topic text.","example":"Billing"},"type":{"type":"string","description":"Topic type.","example":"predefined"},"item_ids":{"type":"array","description":"Associated transcript item identifiers.","example":[1,2],"items":{"type":"integer","format":"int32"}},"mention_by":{"type":"string","description":"Topic mention source.","example":"agent"}},"additionalProperties":false,"description":"Quality management AI topic.","example":{"id":"topic-123","topic":"Billing","type":"predefined"}}}},"additionalProperties":false,"description":"Version 2 interaction analysis. Nested analysis records are intentionally open beyond the supported schema depth.","example":{"format_version":"2.0","analysis_num":1}},"crosstalk_events":{"type":"array","description":"The crosstalk events.","example":[],"items":{"type":"object","properties":{"start_time":{"type":"string","description":"Segment start duration in `HH:mm:ss.SSS` format.","example":"00:01:02.000"},"end_time":{"type":"string","description":"Segment end duration in `HH:mm:ss.SSS` format.","example":"00:01:05.500"}},"additionalProperties":false,"description":"A crosstalk, silence, or hold time segment.","example":{"start_time":"00:01:02.000","end_time":"00:01:05.500"}}},"silence_events":{"type":"array","description":"The silence events.","example":[],"items":{"type":"object","properties":{"start_time":{"type":"string","description":"Segment start duration in `HH:mm:ss.SSS` format.","example":"00:01:02.000"},"end_time":{"type":"string","description":"Segment end duration in `HH:mm:ss.SSS` format.","example":"00:01:05.500"}},"additionalProperties":false,"description":"A crosstalk, silence, or hold time segment.","example":{"start_time":"00:01:02.000","end_time":"00:01:05.500"}}},"hold_events":{"type":"array","description":"The hold events.","example":[],"items":{"type":"object","properties":{"start_time":{"type":"string","description":"Segment start duration in `HH:mm:ss.SSS` format.","example":"00:01:02.000"},"end_time":{"type":"string","description":"Segment end duration in `HH:mm:ss.SSS` format.","example":"00:01:05.500"}},"additionalProperties":false,"description":"A crosstalk, silence, or hold time segment.","example":{"start_time":"00:01:02.000","end_time":"00:01:05.500"}}},"silence_event_threshold":{"type":"integer","description":"The silence event threshold.","format":"int32","example":1},"crosstalk_event_threshold":{"type":"integer","description":"The crosstalk event threshold.","format":"int32","example":1},"recording_url":{"type":"string","description":"The recording URL.","example":"example-value"},"screen_recording_urls":{"type":"array","description":"The screen recording URLs.","example":[],"items":{"type":"string"}},"interaction_summary":{"type":"string","description":"The interaction summary.","example":"example-value"},"screen_recording_status":{"type":"string","description":"The screen recording status.","example":"AVAILABLE","enum":["UNAVAILABLE","AVAILABLE","DELETED","PROCESSING"]},"analysis":{"type":"object","properties":{"topics":{"type":"array","description":"Interaction analysis topics.","example":[],"items":{"type":"object","properties":{"topic_name":{"type":"string","description":"Topic name.","example":"Billing"},"type":{"type":"string","description":"Topic type.","example":"predefined"}},"additionalProperties":false,"description":"Simplified interaction analysis topic.","example":{"topic_name":"Billing","type":"predefined"}}},"indicators":{"type":"array","description":"Interaction analysis indicators.","example":[],"items":{"type":"object","properties":{"indicator_name":{"type":"string","description":"Indicator name.","example":"Customer sentiment"}},"additionalProperties":false,"description":"Simplified interaction analysis indicator.","example":{"indicator_name":"Customer sentiment"}}},"next_steps":{"type":"array","description":"Interaction analysis next steps.","example":[],"items":{"type":"object","properties":{"next_step":{"type":"string","description":"Recommended next step.","example":"Send the customer a billing summary."}},"additionalProperties":false,"description":"Simplified interaction analysis next step.","example":{"next_step":"Send the customer a billing summary."}}},"good_questions":{"type":"array","description":"Interaction analysis good questions.","example":[],"items":{"type":"object","properties":{"good_question":{"type":"string","description":"Effective question asked during the interaction.","example":"How can I best help you today?"}},"additionalProperties":false,"description":"Simplified interaction analysis good question.","example":{"good_question":"How can I best help you today?"}}}},"additionalProperties":false,"description":"Simplified public interaction analysis.","example":{"topics":[],"indicators":[]}}},"additionalProperties":false}},"ai_summary":{"type":"object","properties":{"qm_case_id":{"type":"string","description":"The QM case ID.","example":"example-value"},"summary":{"type":"string","description":"The summary.","example":"example-value"},"status":{"type":"string","description":"The status.","example":"PENDING","enum":["PENDING","GENERATING","COMPLETED","FAILED","SKIPPED_NO_CONTENT","INPUT_TOO_LARGE"]},"trigger_reason":{"type":"string","description":"The trigger reason.","example":"NEW_CASE","enum":["NEW_CASE","TERMINAL_TRANSITION"]},"generated_at":{"type":"string","description":"The generated at value.","format":"date-time","example":"2026-01-15T10:30:00Z"},"last_attempt_at":{"type":"string","description":"The last attempt at value.","format":"date-time","example":"2026-01-15T10:30:00Z"},"error_code":{"type":"string","description":"The error code.","example":"NO_CONTENT","enum":["NO_CONTENT","INPUT_TOO_LARGE","INVALID_RESPONSE","MODEL_CONFIG_UNAVAILABLE","PROVIDER_FAILURE","PERSISTENCE_FAILURE"]},"error_message":{"type":"string","description":"The error message.","example":"example-value"}},"additionalProperties":false,"description":"Returned by default when an authorized summary result exists.","example":{}},"ai_sentiment":{"type":"object","properties":{"qm_case_id":{"type":"string","description":"The QM case ID.","example":"example-value"},"status":{"type":"string","description":"The status.","example":"PENDING","enum":["PENDING","GENERATING","COMPLETED","FAILED","SKIPPED_NO_CONTENT","INPUT_TOO_LARGE"]},"average_sentiment_score":{"type":"number","description":"The average sentiment score.","example":1.5},"average_sentiment_name":{"type":"string","description":"The average sentiment name.","example":"STRONGLY_NEGATIVE","enum":["STRONGLY_NEGATIVE","CLEARLY_NEGATIVE","SLIGHTLY_NEGATIVE","PURELY_NEUTRAL","SLIGHTLY_POSITIVE","CLEARLY_POSITIVE","STRONGLY_POSITIVE","EXTREMELY_POSITIVE"]},"sentiment_summary":{"type":"string","description":"The sentiment summary.","example":"example-value"},"sentiment_evidences":{"type":"array","description":"The sentiment evidences.","example":[],"items":{"type":"string"}},"activity_sentiments":{"type":"array","description":"Returned only when `ai_sentiment_activities` is included.","example":[],"items":{"type":"object","properties":{"source_activity_id":{"type":"string","description":"The source activity ID.","example":"example-value"},"qm_case_activity_key":{"type":"string","description":"The QM case activity key.","example":"example-value"},"activity_type":{"type":"string","description":"The activity type.","example":"example-value"},"created_at":{"type":"string","description":"The created at value.","format":"date-time","example":"2026-01-15T10:30:00Z"},"score":{"type":"integer","description":"The score.","example":1},"sentiment_name":{"type":"string","description":"The sentiment name.","example":"STRONGLY_NEGATIVE","enum":["STRONGLY_NEGATIVE","CLEARLY_NEGATIVE","SLIGHTLY_NEGATIVE","PURELY_NEUTRAL","SLIGHTLY_POSITIVE","CLEARLY_POSITIVE","STRONGLY_POSITIVE","EXTREMELY_POSITIVE"]},"reason":{"type":"string","description":"The reason.","example":"example-value"}},"additionalProperties":false}},"trigger_reason":{"type":"string","description":"The trigger reason.","example":"NEW_CASE","enum":["NEW_CASE","TERMINAL_TRANSITION"]},"generated_at":{"type":"string","description":"The generated at value.","format":"date-time","example":"2026-01-15T10:30:00Z"},"last_attempt_at":{"type":"string","description":"The last attempt at value.","format":"date-time","example":"2026-01-15T10:30:00Z"},"error_code":{"type":"string","description":"The error code.","example":"NO_CONTENT","enum":["NO_CONTENT","INPUT_TOO_LARGE","INVALID_RESPONSE","MODEL_CONFIG_UNAVAILABLE","PROVIDER_FAILURE","PERSISTENCE_FAILURE"]},"error_message":{"type":"string","description":"The error message.","example":"example-value"}},"additionalProperties":false,"description":"Returned by default when an authorized sentiment result exists. `activity_sentiments` is returned only when `ai_sentiment_activities` is included.","example":{}},"performance_info":{"type":"object","properties":{"calibration_info":{"type":"object","properties":{"scorecard":{"type":"object","additionalProperties":true,"description":"Scorecard associated with a calibration or evaluation. Nested scorecard structures are intentionally open beyond the supported schema depth.","example":{"id":"scorecard-123","name":"Customer service quality","scorecard_version":1}},"task_status":{"type":"integer","description":"Numeric status of the calibration task.","format":"int32","example":2},"task_id":{"type":"string","description":"Calibration task identifier.","example":"calibration-task-123"},"operate_type":{"type":"integer","description":"Numeric operation type for the calibration task.","format":"int32","example":1},"session_id":{"type":"string","description":"Calibration session identifier.","example":"session-123"},"draft_status":{"type":"boolean","description":"Whether the calibration is in draft status.","example":false},"can_save_draft":{"type":"boolean","description":"Whether the caller may save the calibration as a draft.","example":true},"score_percent_formatted":{"type":"string","description":"Formatted calibration score percentage.","example":"85%"}},"additionalProperties":false,"description":"Calibration task performance information.","example":{"task_status":2,"task_id":"calibration-task-123","session_id":"session-123","draft_status":false,"can_save_draft":true,"score_percent_formatted":"85%"}},"evaluation_info":{"type":"object","properties":{"ack_status":{"type":"integer","description":"Numeric acknowledgement status.","format":"int32","example":1},"can_edit":{"type":"boolean","description":"Whether the caller may edit the evaluation.","example":true},"can_delete":{"type":"boolean","description":"Whether the caller may delete the evaluation.","example":false},"can_retry":{"type":"boolean","description":"Whether the caller may retry the evaluation.","example":false},"can_save_draft":{"type":"boolean","description":"Whether the caller may save the evaluation as a draft.","example":true},"can_view_evaluation_detail":{"type":"boolean","description":"Whether the caller may view evaluation details.","example":true},"draft_status":{"type":"boolean","description":"Whether the evaluation is a draft.","example":false},"operate_type":{"type":"integer","description":"Numeric operation type for the evaluation.","format":"int32","example":1},"pending":{"type":"boolean","description":"Whether the evaluation is pending.","example":false},"can_dispute":{"type":"boolean","description":"Whether the caller may dispute the evaluation.","example":true},"limit_dispute":{"type":"boolean","description":"Whether dispute actions are restricted.","example":false},"can_reply_dispute":{"type":"boolean","description":"Whether the caller may reply to a dispute.","example":true},"session_id":{"type":"string","description":"Evaluation session identifier.","example":"session-123"},"task_id":{"type":"string","description":"Evaluation task identifier.","example":"evaluation-task-123"},"dispute_history":{"type":"array","description":"History of disputes for the evaluation.","example":[],"items":{"type":"object","additionalProperties":true,"description":"Evaluation dispute history record. Nested dispute objects are intentionally open beyond the supported schema depth.","example":{"completed":true,"update_score":85,"total_score":100}}},"scorecard":{"type":"object","additionalProperties":true,"description":"Scorecard associated with a calibration or evaluation. Nested scorecard structures are intentionally open beyond the supported schema depth.","example":{"id":"scorecard-123","name":"Customer service quality","scorecard_version":1}},"rater":{"type":"object","additionalProperties":true,"description":"Basic Quality Management user information.","example":{"zm_user_id":"user-123","name":"Alex Smith","email":"alex@example.com"}},"agent":{"type":"object","additionalProperties":true,"description":"Basic Quality Management user information.","example":{"zm_user_id":"user-123","name":"Alex Smith","email":"alex@example.com"}},"task_status":{"type":"integer","description":"Numeric status of the evaluation task.","format":"int32","example":2},"auto_score_task_status":{"type":"string","description":"Status of the automated scoring task.","example":"COMPLETED"},"auto_score_task_msg":{"type":"string","description":"Message associated with the automated scoring task.","example":"Automated scoring completed."},"can_feedback":{"type":"boolean","description":"Whether the caller may submit feedback.","example":true},"feedbacks":{"type":"array","description":"Feedback records associated with the evaluation.","example":[],"items":{"type":"object","additionalProperties":true,"description":"Evaluation feedback record.","example":{"biz_type":"EVALUATION","biz_id":"evaluation-123","feedback_type":1}}},"auto_score_version":{"type":"integer","description":"Version of the automated scoring result.","format":"int32","example":1},"is_latest":{"type":"boolean","description":"Whether this is the latest evaluation version.","example":true},"coaching_session_change_logs":{"type":"array","description":"Changes recorded for the associated coaching session.","example":[],"items":{"type":"object","additionalProperties":true,"description":"Coaching session change record. Individual answer change records are intentionally open beyond the supported schema depth.","example":{"version":2,"editor":"Alex Smith","answer_change_logs":[]}}},"score_percent_formatted":{"type":"string","description":"Formatted evaluation score percentage.","example":"85%"},"due_date":{"type":"integer","description":"Evaluation due date as Unix epoch milliseconds.","format":"int64","example":1768464000000},"release_info":{"type":"object","additionalProperties":true,"description":"Release configuration and status for an evaluation result.","example":{"release_type":"IMMEDIATE","release_status":"RELEASED","can_release_result":true}}},"additionalProperties":false,"description":"Manual or automated evaluation performance information.","example":{"task_status":2,"task_id":"evaluation-task-123","session_id":"session-123","can_edit":true,"can_feedback":true,"is_latest":true,"score_percent_formatted":"85%"}},"auto_score_info":{"type":"object","properties":{"ack_status":{"type":"integer","description":"Numeric acknowledgement status.","format":"int32","example":1},"can_edit":{"type":"boolean","description":"Whether the caller may edit the evaluation.","example":true},"can_delete":{"type":"boolean","description":"Whether the caller may delete the evaluation.","example":false},"can_retry":{"type":"boolean","description":"Whether the caller may retry the evaluation.","example":false},"can_save_draft":{"type":"boolean","description":"Whether the caller may save the evaluation as a draft.","example":true},"can_view_evaluation_detail":{"type":"boolean","description":"Whether the caller may view evaluation details.","example":true},"draft_status":{"type":"boolean","description":"Whether the evaluation is a draft.","example":false},"operate_type":{"type":"integer","description":"Numeric operation type for the evaluation.","format":"int32","example":1},"pending":{"type":"boolean","description":"Whether the evaluation is pending.","example":false},"can_dispute":{"type":"boolean","description":"Whether the caller may dispute the evaluation.","example":true},"limit_dispute":{"type":"boolean","description":"Whether dispute actions are restricted.","example":false},"can_reply_dispute":{"type":"boolean","description":"Whether the caller may reply to a dispute.","example":true},"session_id":{"type":"string","description":"Evaluation session identifier.","example":"session-123"},"task_id":{"type":"string","description":"Evaluation task identifier.","example":"evaluation-task-123"},"dispute_history":{"type":"array","description":"History of disputes for the evaluation.","example":[],"items":{"type":"object","additionalProperties":true,"description":"Evaluation dispute history record. Nested dispute objects are intentionally open beyond the supported schema depth.","example":{"completed":true,"update_score":85,"total_score":100}}},"scorecard":{"type":"object","additionalProperties":true,"description":"Scorecard associated with a calibration or evaluation. Nested scorecard structures are intentionally open beyond the supported schema depth.","example":{"id":"scorecard-123","name":"Customer service quality","scorecard_version":1}},"rater":{"type":"object","additionalProperties":true,"description":"Basic Quality Management user information.","example":{"zm_user_id":"user-123","name":"Alex Smith","email":"alex@example.com"}},"agent":{"type":"object","additionalProperties":true,"description":"Basic Quality Management user information.","example":{"zm_user_id":"user-123","name":"Alex Smith","email":"alex@example.com"}},"task_status":{"type":"integer","description":"Numeric status of the evaluation task.","format":"int32","example":2},"auto_score_task_status":{"type":"string","description":"Status of the automated scoring task.","example":"COMPLETED"},"auto_score_task_msg":{"type":"string","description":"Message associated with the automated scoring task.","example":"Automated scoring completed."},"can_feedback":{"type":"boolean","description":"Whether the caller may submit feedback.","example":true},"feedbacks":{"type":"array","description":"Feedback records associated with the evaluation.","example":[],"items":{"type":"object","additionalProperties":true,"description":"Evaluation feedback record.","example":{"biz_type":"EVALUATION","biz_id":"evaluation-123","feedback_type":1}}},"auto_score_version":{"type":"integer","description":"Version of the automated scoring result.","format":"int32","example":1},"is_latest":{"type":"boolean","description":"Whether this is the latest evaluation version.","example":true},"coaching_session_change_logs":{"type":"array","description":"Changes recorded for the associated coaching session.","example":[],"items":{"type":"object","additionalProperties":true,"description":"Coaching session change record. Individual answer change records are intentionally open beyond the supported schema depth.","example":{"version":2,"editor":"Alex Smith","answer_change_logs":[]}}},"score_percent_formatted":{"type":"string","description":"Formatted evaluation score percentage.","example":"85%"},"due_date":{"type":"integer","description":"Evaluation due date as Unix epoch milliseconds.","format":"int64","example":1768464000000},"release_info":{"type":"object","additionalProperties":true,"description":"Release configuration and status for an evaluation result.","example":{"release_type":"IMMEDIATE","release_status":"RELEASED","can_release_result":true}}},"additionalProperties":false,"description":"Manual or automated evaluation performance information.","example":{"task_status":2,"task_id":"evaluation-task-123","session_id":"session-123","can_edit":true,"can_feedback":true,"is_latest":true,"score_percent_formatted":"85%"}}},"additionalProperties":false,"description":"Performance information for the case. Returned when the caller has performance-information access.","example":{"calibration_info":{"task_status":2,"task_id":"calibration-task-123","session_id":"session-123","draft_status":false},"evaluation_info":{"task_status":2,"task_id":"evaluation-task-123","session_id":"session-123","can_edit":true,"can_feedback":true}}}},"additionalProperties":false}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  The case identifier or request is invalid. \n\n "},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  Authentication is missing, invalid, or expired. \n\n "},"403":{"description":"**HTTP Status Code:** `403` <br>\n Forbidden  The caller is authenticated but does not have the required case read scopes or lacks access to the requested case data. \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  The case does not exist or is outside the caller's visible scope. \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. The public API rate limit was exceeded. \n\n "},"500":{"description":"**HTTP Status Code:** `500` <br>\n Internal Server Error  An unexpected server side failure occurred. \n\n "}},"security":[{"openapi_authorization":[]}],"x-extensions":{"x-permissions":["AllInteractions:Read","InteractionPerformanceMgt:Read"],"x-macro-scopes":["qm_cases:read","qm_cases:read:admin"],"x-granular-scopes":["zoom_quality_management:read:cases","zoom_quality_management:read:cases:admin"]}}},"/qm/automated_evaluations":{"get":{"tags":["Evaluations"],"summary":"List automated evaluations","description":"List automated evaluations.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `qm_evaluations:read:admin`,`qm_evaluations:read`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_quality_management:read:evaluations:admin`,`zoom_quality_management:read:evaluations`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"ListAutomatedEvaluations","parameters":[{"name":"status","in":"query","description":"The automated evaluation's current status.","required":false,"schema":{"type":"string","example":"COMPLETED","enum":["COMPLETED","PROCESSING","FAILED"]}},{"name":"agent_id","in":"query","description":"The scored agent's user ID.","required":false,"schema":{"type":"string","example":"httgPnTgTxq0d65-alfYVw"}},{"name":"interaction_id","in":"query","description":"The interaction ID.","required":false,"schema":{"type":"string","example":"X51n17BZQTqKtxwF4mmTIw"}},{"name":"page_size","in":"query","description":"Default - 30\nMaximum - 100","required":false,"schema":{"type":"integer","example":30}},{"name":"from","in":"query","description":"The start date, in `yyyy-MM-dd'T'HH:mm:ss'Z'` format.","required":false,"schema":{"type":"string","example":"2025-02-01T19:13:02Z"}},{"name":"to","in":"query","description":"The end date, in `yyyy-MM-dd'T'HH:mm:ss'Z'` format.","required":false,"schema":{"type":"string","example":"2025-02-02T19:13:05Z"}},{"name":"next_page_token","in":"query","description":"Use the next page token to paginate through large result sets. A next page token is returned whenever the set of available results exceeds the current page size. This token's expiration period is 15 minutes.","required":false,"schema":{"type":"string","example":"R4aF9Oj0fVM2hhezJTEmSKaBSkfesDwGy42"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200`    Successfully listed user's automated evaluations.","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"number","description":"The total number of all the records available across pages.","example":51},"page_size":{"type":"number","description":"The number of records returned within a single API call.","example":20},"data":{"maxItems":100,"minItems":0,"type":"array","description":"Information about the automated evaluations.","items":{"type":"object","properties":{"id":{"type":"string","description":"The automated evaluation task ID.","example":"0e73a69f8f104d24a589fa0c615abca8"},"account_id":{"type":"string","description":"The account ID.","example":"SY-AEWW6Ruqgt89_T2zqBg"},"modify_time":{"type":"string","description":"The date when the automated evaluation was modified, in `yyyy-MM-dd'T'HH:mm:ss'Z'` format.","example":"2024-05-28T09:52:22Z"},"create_time":{"type":"string","description":"The date when the automated evaluation was created, in `yyyy-MM-dd'T'HH:mm:ss'Z'` format.","example":"2024-05-28T09:52:22Z"},"interaction_id":{"type":"string","description":"The interaction ID.","example":"q9DyYF8iSXa3PVAhb6nekQ"},"scorecard_id":{"type":"string","description":"The automated evaluation scorecard ID.","example":"2uJ4u83yQ_qbyyFDmxsMcQ"},"agent_info":{"type":"object","properties":{"user_id":{"type":"string","description":"The evaluation's agent user ID.","example":"httgPnTgTxq0d65-alfYVw"},"display_name":{"type":"string","description":"The evaluation's agent user display name.","example":"Ashlee York"}},"description":"The agent information."},"scorecard_name":{"type":"string","description":"The automated scorecard name.","example":"Customer Care"},"scoring_format":{"type":"string","description":"The scorecard's scoring format .","example":"percentage","enum":["points","percentage"]},"total_score":{"type":"number","description":"The total score on the scorecard.","example":50},"evaluation_score":{"type":"number","description":"The overall score of the automated evaluation, calculated based on the scorecard and answers.","example":10},"interaction_deleted":{"type":"boolean","description":"Whether the interactions was deleted.","example":false},"status":{"type":"string","description":"The evaluation's current status.","example":"COMPLETED","enum":["COMPLETED","PROCESSING","FAILED"]}},"description":"Information about the automated evaluations."}},"next_page_token":{"type":"string","description":"Use the next page token to paginate through large result sets. A next page token is returned whenever the set of the available result list exceeds the page size. This token's expiration period is 15 minutes.","example":"R4aF9Oj0fVM2hhezJTEmSKaBSkfesDwGy42"}}}}}}},"security":[{"openapi_authorization":[]}],"x-extensions":{"x-permissions":["InteractionPerformanceMgt:Read","AssignEvaluations:Edit","AllInteractions:Read"],"x-macro-scopes":["qm_evaluations:read:admin","qm_evaluations:read"],"x-granular-scopes":["zoom_quality_management:read:evaluations:admin","zoom_quality_management:read:evaluations"]}}},"/qm/evaluation":{"get":{"tags":["Evaluations"],"summary":"List evaluations","description":"List manually completed evaluations.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `qm_evaluations:read:admin`,`qm_evaluations:read`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_quality_management:read:evaluations`,`zoom_quality_management:read:evaluations:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"Listevaluations","parameters":[{"name":"status","in":"query","description":"The evaluation's current status.","required":false,"schema":{"type":"string","example":"Active","enum":["Active","Completed","Pending","Expired","Canceled"]}},{"name":"agent_ids","in":"query","description":"The scored agents' user IDs.","required":false,"schema":{"type":"string","example":"httgPnTgTxq0d65-alfYVw,b0_yDuNGSq65EF8i1f0PcQ"}},{"name":"evaluator_id","in":"query","description":"The evaluators' user IDs.","required":false,"schema":{"type":"string","example":"b0_yDuNGSq65EF8i1f0PcQ"}},{"name":"acknowledgement_status","in":"query","description":"The acknowledgement status.","required":false,"schema":{"type":"string","example":"Pending","enum":["Pending","Complete","Auto complete","None"]}},{"name":"interaction_id","in":"query","description":"The interaction ID.","required":false,"schema":{"type":"string","example":"X51n17BZQTqKtxwF4mmTIw"}},{"name":"page_size","in":"query","description":"Default - 30\nMaximum - 100","required":false,"schema":{"type":"integer","example":30}},{"name":"from","in":"query","description":"The start date in `yyyy-MM-dd'T'HH:mm:ss'Z'` format.","required":false,"schema":{"type":"string","example":"2025-02-01T19:13:02Z"}},{"name":"to","in":"query","description":"The end date in `yyyy-MM-dd'T'HH:mm:ss'Z'` format.","required":false,"schema":{"type":"string","example":"2025-02-02T19:13:05Z"}},{"name":"next_page_token","in":"query","description":"Use the next page token to paginate through large result sets. A next page token is returned whenever the set of available results exceeds the current page size. This token's expiration period is 15 minutes.","required":false,"schema":{"type":"string","example":"R4aF9Oj0fVM2hhezJTEmSKaBSkfesDwGy42"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200`    Successfully listed user's evaluations.","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"number","description":"The total number of all the records available across pages.","example":51},"page_size":{"type":"number","description":"The number of records returned within a single API call.","example":20},"data":{"maxItems":100,"minItems":0,"type":"array","description":"Information about the evaluations.","items":{"type":"object","properties":{"id":{"type":"string","description":"The evaluation task ID.","example":"0e73a69f8f104d24a589fa0c615abca8"},"account_id":{"type":"string","description":"The account ID.","example":"SY-AEWW6Ruqgt89_T2zqBg"},"user_id":{"type":"string","description":"The Zoom user ID.","example":"httgPnTgTxq0d65-alfYVw"},"creator_id":{"type":"string","description":"The evaluation's creator Zoom user ID.","example":"b0_yDuNGSq65EF8i1f0PcQ"},"modify_time":{"type":"string","description":"The date when the evaluation was modified, in `yyyy-MM-dd'T'HH:mm:ss'Z'` format.","example":"2024-05-28T09:52:22Z"},"create_time":{"type":"string","description":"The date when the evaluation was created, in `yyyy-MM-dd'T'HH:mm:ss'Z'` format.","example":"2024-05-28T09:52:22Z"},"channel_type":{"type":"string","description":"The interaction's channel type.","example":"VIDEO","enum":["VIDEO","AUDIO","MANUAL","MESSAGE"]},"task_name":{"type":"string","description":"The evaluation task name.","example":"evaluation_q9DyYF8iSXa3PVAhb6nekQ"},"interaction_id":{"type":"string","description":"The interaction ID.","example":"q9DyYF8iSXa3PVAhb6nekQ"},"scorecard_id":{"type":"string","description":"The evaluation scorecard ID.","example":"2uJ4u83yQ_qbyyFDmxsMcQ"},"creator_info":{"type":"object","properties":{"user_id":{"type":"string","description":"The evaluation's creator Zoom user ID.","example":"b0_yDuNGSq65EF8i1f0PcQ"},"display_name":{"type":"string","description":"The evaluation's creator user display name.","example":"Rick Arps"}},"description":"The evaluation creator information."},"agent_info":{"type":"object","properties":{"user_id":{"type":"string","description":"The evaluation's agent user ID.","example":"httgPnTgTxq0d65-alfYVw"},"display_name":{"type":"string","description":"The evaluation's agent user display name.","example":"Ashlee York"}},"description":"The agent information."},"evaluators_info":{"type":"array","description":"The evaluators' information.","items":{"type":"object","properties":{"user_id":{"type":"string","description":"The evaluation's evaluator user ID.","example":"b0_yDuNGSq65EF8i1f0PcQ"},"display_name":{"type":"string","description":"The evaluation's evaluator user display name.","example":"Rick Arps"}}}},"scorecard_name":{"type":"string","description":"The evaluation scorecard name.","example":"Customer Care"},"scoring_format":{"type":"string","description":"The scorecard's scoring format .","example":"percentage","enum":["points","percentage"]},"total_score":{"type":"number","description":"The total score on the scorecard.","example":50},"evaluation_score":{"type":"number","description":"The overall score of the evaluation, calculated based on the scorecard and answers.","example":10},"interaction_deleted":{"type":"boolean","description":"Whether the interactions was deleted.","example":false},"status":{"type":"string","description":"The evaluation's current status.","example":"Active","enum":["Active","Completed","Pending","Expired","Cancled"]},"acknowledgement_status":{"type":"string","description":"The acknowledgement status.","example":"Pending","enum":["Pending","Complete","Auto Complete","None"]},"completion_date":{"type":"string","description":"Estimated completion time.","example":"2026-03-16T10:45:00Z"}},"description":"Information about the evaluations."}},"next_page_token":{"type":"string","description":"Use the next page token to paginate through large result sets. A next page token is returned whenever the set of the available result list exceeds the page size. This token's expiration period is 15 minutes.","example":"R4aF9Oj0fVM2hhezJTEmSKaBSkfesDwGy42"}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  Bad Request \n\n "},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  Unauthorized \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_authorization":[]}],"x-extensions":{"x-permissions":["InteractionPerformanceMgt:Read","AssignEvaluations:Edit","AllInteractions:Read"],"x-macro-scopes":["qm_evaluations:read:admin","qm_evaluations:read"],"x-granular-scopes":["zoom_quality_management:read:evaluations","zoom_quality_management:read:evaluations:admin"]}}},"/qm/evaluation/{evaluationId}":{"get":{"tags":["Evaluations"],"summary":"View evaluation detail","description":"View a specific interaction's evaluation detail.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `qm_evaluations:read`,`qm_evaluations:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_quality_management:read:evaluations`,`zoom_quality_management:read:evaluations:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"EvaluationDetail","parameters":[{"name":"evaluationId","in":"path","description":"The evaluation's ID.","required":true,"schema":{"type":"string","example":"aI9HM3ZsEScAa"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200`    Successfully view the evaluation detail.","content":{"application/json":{"schema":{"type":"object","properties":{"scorecard":{"type":"object","properties":{"scorecard_id":{"type":"string","description":"The scorecard's ID.","example":"CaBoBGvDSCmYt5GDDxP4-Q"},"scorecard_name":{"type":"string","description":"The name of the scorecard used for evaluation.","example":"AAAAAAAA Automated DEMO test 1212 TEST 111"},"sections":{"maxItems":20,"minItems":1,"type":"array","description":"The scorecard section infomation.","items":{"type":"object","properties":{"name":{"type":"string","description":"The name of the section within the scorecard.","example":"Service Attitude"},"weight":{"type":"number","description":"The weight of the section in the overall score calculation.","example":34},"order":{"type":"number","description":"The order of this section in the scorecard.","example":1},"questions":{"maxItems":100,"minItems":1,"type":"array","description":"The questions.","items":{"type":"object","properties":{"question_id":{"type":"string","description":"The question's ID.","example":"7jNGHA0QSRGdsi-R03d8tQ"},"type":{"type":"string","description":"The question's type.","example":"Rating Scale","enum":["Yes/No","Single Choice","Rating Scale"]},"title":{"type":"string","description":"The question's title or main text.","example":"Did the customer service representative demonstrate patience and friendliness?"},"description":{"type":"string","description":"A detailed description or additional information about the question.","example":"Evaluate the agent's service attitude."},"options":{"maxItems":20,"minItems":1,"type":"array","description":"The options.","items":{"type":"object","properties":{"option_id":{"type":"string","description":"The option's ID.","example":"m_DJVk5BS7yqoR2ayN16kw"},"label":{"type":"string","description":"The option's display text.","example":"Yes"},"value":{"type":"string","description":"The option's value.","example":"Yes"},"auto_fail":{"type":"boolean","description":"Indicates whether selecting this option causes an automatic failure,  `true` or `false`.","example":false},"points":{"type":"number","description":"The option's points.","example":10}},"description":"The option."}},"answer_id":{"type":"string","description":"The ID of the selected answer for this question.","example":"m_DJVk5BS7yqoR2ayN16kw"},"answer_label":{"type":"string","description":"The label of the selected answer for this question.","example":"Yes"},"score":{"type":"number","description":"The actual score obtained in this question, not exceeding the total_score.","example":10},"scale":{"type":"object","properties":{"has_na_option":{"type":"boolean","description":"Indicates whether there is an `N/A` option.","example":true},"high_label":{"type":"string","description":"The high score label.","example":"Excellent"},"low_label":{"type":"string","description":"The low score label.","example":"Poor"},"scale_max":{"type":"integer","description":"Maximum score.","example":10},"scale_min":{"type":"integer","description":"Minimum score.","example":1}},"description":"The information about rating scale type question."},"total_score":{"type":"number","description":"The maximum possible score that can be achieved for this question.","example":10}},"description":"The questions."}},"score":{"type":"number","description":"The actual score obtained in this section, not exceeding the total_score.","example":20},"total_score":{"type":"number","description":"The maximum possible score that can be achieved for this section.","example":30}}}},"score":{"type":"number","description":"The actual score obtained in this evaluation, not exceeding the total_score.","example":90},"total_score":{"type":"number","description":"The maximum possible score that can be achieved for this evaluation.","example":100},"evaluator":{"type":"object","properties":{"name":{"type":"string","description":"The name of the person who conducted the evaluation.","example":"Admin3"},"user_id":{"type":"string","description":"The evaluator's Zoom user ID.","example":"ycEUjKmDSnuPwF33KLTxJg"}},"description":"The evaluator information."},"create_time":{"type":"string","description":"The date when the evaluation was created, in `yyyy-MM-dd'T'HH:mm:ss'Z'` format.","example":"2024-05-28T09:52:22Z"},"modify_time":{"type":"string","description":"The date when the evaluation was modified, in `yyyy-MM-dd'T'HH:mm:ss'Z'` format.","example":"2024-05-28T09:52:22Z"},"acknowledgment_status":{"type":"string","description":"The evaluation's acknowledgment status.","example":"Complete","enum":["Pending","Complete","Auto complete","None"]},"dispute_status":{"type":"string","description":"The evaluation's dispute status.","example":"None","enum":["None","Pending","Complete"]},"interaction_id":{"type":"string","description":"The ID of the interaction being evaluated.","example":"yBe0fI6kTFG5IyThF8eRXg"},"engagement_id":{"type":"string","description":"The ID of the engagement associated with the interaction.","example":"e59gNVtjTuS--NjwquFKQA"},"agent_name":{"type":"string","description":"The name of the agent involved in the interaction being evaluated.","example":"The agent's name."},"agent_user_id":{"type":"string","description":"The user ID of the agent involved in the interaction.","example":"The agent's ID."},"completion_date":{"type":"string","description":"Estimated completion time.","example":"2026-03-16T10:45:00Z"}},"description":"The scorecard's detail."}}}}}},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  Unauthorized \n\n "},"403":{"description":"**HTTP Status Code:** `403` <br>\n Forbidden  Forbidden \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  Not Found \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_authorization":[]}],"x-extensions":{"x-permissions":["InteractionPerformanceMgt:Read","AssignEvaluations:Edit","AllInteractions:Read"],"x-macro-scopes":["qm_evaluations:read","qm_evaluations:read:admin"],"x-granular-scopes":["zoom_quality_management:read:evaluations","zoom_quality_management:read:evaluations:admin"]}}},"/qm/interactions":{"get":{"tags":["Interactions"],"summary":"List interactions","description":"List interactions.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `qm_interactions:read`,`qm_interactions:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_quality_management:read:interactions`,`zoom_quality_management:read:interactions:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"ListInteractions","parameters":[{"name":"from","in":"query","description":"The start date in y`yyy-MM-dd'T'HH:mm:ss'Z'` format.","required":false,"schema":{"type":"string","example":"2020-05-01T19:13:02Z"}},{"name":"to","in":"query","description":"The end date in `yyyy-MM-dd'T'HH:mm:ss'Z'` format.","required":false,"schema":{"type":"string","example":"2020-05-02T19:13:05Z"}},{"name":"indicator_id","in":"query","description":"The indicator ID to query.","required":false,"schema":{"type":"string","example":"aI9HM3ZsEScAa"}},{"name":"topic","in":"query","description":"The topic words to query.","required":false,"schema":{"type":"string","example":"thanks"}},{"name":"engagement_id","in":"query","description":"The engagement's ID to query.","required":false,"schema":{"type":"string","example":"aI9HM3ZsEScAa"}},{"name":"scored","in":"query","description":"If interactions are scored.","required":false,"schema":{"type":"boolean","example":true}},{"name":"user_ids","in":"query","description":"The agent IDs, separated by commas.","required":false,"schema":{"type":"string","example":"ycEUjKmDSnuPwF33KLTxJg,vBKuLsR2QeK_mMo0KQsEew"}},{"name":"channels","in":"query","description":"The channel types, separated by commas.","required":false,"schema":{"type":"string","example":"VIDEO, AUDIO"}},{"name":"direction","in":"query","description":"The direction of the call.\n* `inbound` \n* `outbound`..","required":false,"schema":{"type":"string","example":"inbound"}},{"name":"dispositions","in":"query","description":"The disposition names, separated by commas.","required":false,"schema":{"type":"string","example":"aaa,Ping Test"}},{"name":"language","in":"query","description":"The primary language.","required":false,"schema":{"type":"string","example":"en,ja"}},{"name":"queues","in":"query","description":"The queue IDs, separated by commas.","required":false,"schema":{"type":"string","example":"Je4zLPZ-SBiLCiebE35ALQ,SC3x7iqnRm6QVeIuxSnzuA"}},{"name":"next_page_token","in":"query","description":"Use the next page token to paginate through large result sets. A next page token is returned whenever the set of available results exceeds the current page size. This token's expiration period is 15 minutes.","required":false,"schema":{"type":"string","example":"R4aF9Oj0fVM2hhezJTEmSKaBSkfesDwGy42"}},{"name":"page_size","in":"query","description":"**Default**:30\n**Maximum**:100","required":false,"schema":{"maximum":100,"exclusiveMaximum":true,"type":"integer","example":30,"default":30}},{"name":"time_zone","in":"query","description":"The user's time zone.","required":false,"schema":{"type":"string","example":"America/Los_Angeles"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200`    Successfully listed user's interactions.","content":{"application/json":{"schema":{"type":"object","properties":{"total_records":{"type":"integer","description":"The total number of all the records available across pages.","example":50},"page_size":{"type":"number","description":"The number of records returned within a single API call.","example":30},"interactions":{"maxItems":300,"type":"array","description":" Information about the interaction.","items":{"required":["interaction_info","start_time"],"type":"object","properties":{"start_time":{"type":"string","description":"The start date in yyyy-MM-dd'T'HH:mm:ss'Z' format.","example":"2020-05-01T19:13:02Z"},"duration":{"type":"number","description":"The interaction duration in minutes.","example":5},"queue_id":{"type":"string","description":"The call queue id.","example":"Je4zLPZ-SBiLCiebE35ALQ"},"queue_name":{"type":"string","description":"The call queue name.","example":"Demo"},"interaction_info":{"required":["interaction_id"],"type":"object","properties":{"from":{"type":"string","description":"The caller's phone number in E.164 format.","example":"+16692520210"},"to":{"type":"string","description":"The recipient's phone number in E.164 format.","example":"+12364352078"},"interaction_id":{"type":"string","description":"The interaction id.","example":"X51n17BZQTqKtxwF4mmTIw"},"agent_name":{"type":"string","description":"The agent name.","example":"Admin3"},"consumer_name":{"type":"string","description":"The consumer name.","example":"+16692520210"},"channel_type":{"type":"string","description":"The channel type, includes VIDEO, MANUAL, SMS, AUDIO and WEB_CHAT.","example":"AUDIO","enum":["VIDEO","MANUAL","SMS","AUDIO","WEB_CHAT"]},"associated_ids":{"maxItems":100,"type":"array","description":"The associated interaction ids.","items":{"type":"string","description":"The associated interaction id.","example":"xxxx"}},"evaluations":{"maxItems":10,"minItems":0,"type":"array","description":"The associated evaluations.","items":{"type":"object","properties":{"evaluation_id":{"type":"string","description":"The evaluation ID.","example":"2c8704b1bc374bb981dd66428ca3eb7b"},"evaluation_type":{"type":"string","description":"The evaluation type.","example":"Manual scoring","enum":["Manual","Automated"]}}}}},"description":"The interaction infomation."},"engagement_id":{"type":"string","description":"The engagement id.","example":"PH6wferlTACAfBzYGAVOYg"},"direction":{"type":"string","description":"The direction.","example":"inbound"},"disposition":{"type":"string","description":"The disposition","example":"dev-disponsition"},"silence_event_count":{"type":"integer","description":"The count of silence event.","example":2},"crosstalk_event_count":{"type":"integer","description":"The count of crosstalk event.","example":2},"hold_event_count":{"type":"integer","description":"The count of hold event.","example":3},"scorecard_name":{"type":"string","description":"The scorecard name.","example":"test Kraig 1227"},"summary":{"type":"object","properties":{"evaluation_score":{"type":"number","description":"The evaluation score.","example":58.63},"sentiment_score":{"type":"number","description":"The sentiment score.","example":58.63},"engagement_score":{"type":"number","description":"The engagement score.","example":58.63}},"description":"The summary."},"primary_language":{"type":"string","description":"The primary language.","example":"en"},"screen_recording_status":{"type":"string","description":"The status of the interaction screen recording. \n**UNAVAILABLE, AVAILABLE, DELETED**","example":"AVAILABLE","enum":["UNAVAILABLE","AVAILABLE","DELETED"]}},"description":" Information about the interaction.\n"}},"next_page_token":{"type":"string","description":" The next page token is used to paginate through large result sets. A next page token will be returned whenever the set of the available result list exceeds the page size. The expiration period is 15 minutes.","example":"R4aF9Oj0fVM2hhezJTEmSKaBSkfesDwGy42"}},"description":"response"}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  Bad Request \n\n **Error Code:** `1001` <br>\n The from or to time is invalid. <br>\n"},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  Unauthorized \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  Not Found \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_authorization":[]}],"x-extensions":{"x-permissions":["AllInteractions:Read"],"x-macro-scopes":["qm_interactions:read","qm_interactions:read:admin"],"x-granular-scopes":["zoom_quality_management:read:interactions","zoom_quality_management:read:interactions:admin"]}},"post":{"tags":["Interactions"],"summary":"Add an interaction","description":"Add an interaction by a third party download URL.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `qm_interactions:write:admin`,`qm_interactions:write`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_quality_management:write:interactions`,`zoom_quality_management:write:interactions:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `1`","operationId":"Addinteraction","requestBody":{"description":"Add an interaction by a third party download URL.","content":{"application/json":{"schema":{"required":["download_url"],"type":"object","properties":{"download_url":{"type":"string","description":"The third party download URL.","example":"https://www.example.com/uploads/InboundSampleRecording.mp3"},"interaction_info":{"required":["channel_type"],"type":"object","properties":{"from":{"type":"string","description":"The caller's phone number in E.164 format.","example":"+12053546173"},"to":{"type":"string","description":"The recipient's phone number in E.164 format.","example":"+12095422197"},"consumer_name":{"type":"string","description":"The consumer's name.","example":"Jill Chill"},"channel_type":{"type":"string","description":"The interaction's channel.","example":"video","enum":["video","voice"]},"agent_id":{"type":"string","description":"The agent's user ID.","example":"ycEUjKmDSnuPwF33KLTxJg"},"agent_email":{"type":"string","description":"The agent's email.","example":"example_admin@example.com"}},"description":"The interaction infomation."},"start_time":{"type":"string","description":"The interaction start time in `yyyy-MM-dd'T'HH:mm:ss'Z'` format.","example":"2025-09-01T19:13:02Z"},"direction":{"type":"string","description":"The call's direction.\n* `inbound` \n* `outbound`","example":"inbound","enum":["inbound","outbound"]},"queue_id":{"type":"string","description":"The Contact Center queue's ID.","example":"zxcv12m"},"disposition":{"type":"string","description":"The disposition's name.","example":"dispostion_a"},"primary_language":{"type":"string","description":"The primary language. \nIf left empty, the system automatically detects the language. If specified, the system transcribes using the given language.\n[**Supported language codes**](https://developers.zoom.us/docs/api/references/abbreviations/#languages)","example":"en-US","enum":["en-GB","en-US","ar","da-DK","de-DE","es-ES","es-MX","fr-CA","fr-FR","it-IT","ja","ko-KR","nl-NL","pt-BR","pt-PT","ru","zh-CN","zh-HK"]}}}}}},"responses":{"201":{"description":"**HTTP Status Code:** `201`    Successfully added the user's interaction.","content":{"application/json":{"schema":{"type":"object","properties":{"interaction_id":{"type":"string","description":"The added interaction ID.","example":"QMp3e6_WShCVuifNbrQd4w"}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  Bad Request \n\n **Error Code:** `1001` <br>\n The interaction start time is invalid. <br>\n"},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  Unauthorized \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  Not Found \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_authorization":[]}],"x-extensions":{"x-permissions":["AllInteractions:Edit"],"x-macro-scopes":["qm_interactions:write:admin","qm_interactions:write"],"x-granular-scopes":["zoom_quality_management:write:interactions","zoom_quality_management:write:interactions:admin"]}}},"/qm/interactions/{interactionId}":{"get":{"tags":["Interactions"],"summary":"View interaction detail","description":"View the details of a specific interaction.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `qm_interactions:read:admin`,`qm_interactions:read`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_quality_management:read:interactions`,`zoom_quality_management:read:interactions:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"InteractionDetail","parameters":[{"name":"interactionId","in":"path","description":"The interaction ID.","required":true,"schema":{"type":"string","example":"VgKcwkLoTPy80OyNcUo2Yg"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200`    Successfully view the interaction detail.","content":{"application/json":{"schema":{"required":["interaction_info"],"type":"object","properties":{"summary":{"type":"object","properties":{"evaluation_score":{"type":"number","description":"The evaluation score.","example":1},"sentiment_score":{"type":"number","description":"The sentiment score.","example":61.19},"sentiment_score_reason":{"type":"string","description":"The sentiment score reason.","example":"Customer frustration detected during escalation"},"engagement_score":{"type":"number","description":"The engagement score.","example":5.546720115175143}},"description":"The summary infomation."},"metrics":{"type":"object","properties":{"talk_to_listen_ratio":{"maxItems":100,"type":"array","description":"The speaker's talk-listen ratio.\n","items":{"type":"object","properties":{"speaker_user_id":{"type":"string","description":"The speaker's user ID.","example":"ycEUjKmDSnuPwF33KLTxJg"},"value":{"type":"number","description":"The speaker's talk-listen ratio.","example":0.4311976503861636}}}},"longest_monolog":{"maxItems":100,"type":"array","description":"The speaker's longest monologue.","items":{"type":"object","properties":{"speaker_user_id":{"type":"string","description":"The speaker's user ID.","example":"ycEUjKmDSnuPwF33KLTxJg"},"value":{"type":"number","description":"The speaker's longest monologue duration, in **seconds**.","example":8.430000000000007}}}},"talk_speed":{"maxItems":100,"type":"array","description":"The speaker's talk speed.","items":{"type":"object","properties":{"speaker_user_id":{"type":"string","description":"The speaker's user ID.","example":"ycEUjKmDSnuPwF33KLTxJg"},"value":{"type":"number","description":"The speaker's talk speed, in words per minute.","example":121.0898082744702}}}},"filler_words":{"maxItems":100,"type":"array","description":"The speaker's filler words.","items":{"type":"object","properties":{"speaker_user_id":{"type":"string","description":"The speaker's user ID.","example":"ycEUjKmDSnuPwF33KLTxJg"},"value":{"type":"number","description":"The speaker's filler words count per minute.","example":0}}}},"patience":{"maxItems":100,"type":"array","description":"The speaker's patience.","items":{"type":"object","properties":{"speaker_user_id":{"type":"string","description":"The speaker's user ID.","example":"ycEUjKmDSnuPwF33KLTxJg"},"value":{"type":"number","description":"The speaker's patience duration, in seconds.","example":1.24}}}}},"description":"The metrics infomation."},"start_time":{"type":"string","description":"The start date, in `yyyy-MM-dd'T'HH:mm:ss'Z'` format.","example":"2024-05-28T09:52:22Z"},"duration":{"type":"number","description":"The interaction duration in minutes.","example":8},"queue_id":{"type":"string","description":"The queue ID to query.","example":"d5qAagKnQ7-UO_VsdiPdQA"},"queue_name":{"type":"string","description":"The queue name to query.","example":"Demo"},"recording_url":{"type":"string","description":"The recording URL.","example":"https://example.com/file/YZ75Jmq8TICELRiufFmTrg?filename=GMT20240528-095222_VgKcwkLoTPy80OyNcUo2Yg_VoiceRecording.mp3&jwt=eyJrIjoiMVI2cVdsWGIiLCJhbGciOiJFUzI1NiJ9.eyJhdWQiOiJ6ZnMiLCJkaWciOiJhN2E5MzE1ZWI2YTU5Yzk0MDgwM2VjNGE4MGNkMzk3YWRmYWVhODUwOWI5MThiMTNkOGVlOTgxMzQ1NjhiYmRkIiwiaGRpZyI6ZmFsc2UsImlpYyI6ImRldiIsImV4cCI6MTcyNTYxNzYwNywiaWF0IjoxNzI1MDEyODA3LCJvcmkiOiJ6b29tX2lxIiwiaXNzIjoiZmlsZSJ9.zjyJVGX9N3_hdu8zvytae5JvsFLgff17-39PpbMgpyh6RC7zJCRiHjBnbsV1J3ac4bgtDUGiG_4-M1G8YY0PuQ&mode=play"},"screen_recording_urls":{"maxItems":20,"type":"array","description":"The screen recording URLs.","items":{"type":"string","description":"The screen recording URL.","example":"https://example.com/file/6GmXHipBT_CC3ncyX6d76w?filename=GMT20240812-103352_Recording_3840x2160.mp4&jwt=eyJrIjoiMVI2cVdsWGIiLCJhbGciOiJFUzI1NiJ9.eyJoZGlnIjpmYWxzZSwiaWljIjoiZGV2IiwiZGlnIjoiM2UxOGVjYzQyZmE5Yjk0OTcyOTlhYTlhZWMxNzg2YjgxNmJkMWRlNzQ5ZmZmNGQ1ODZiZDNhY2ViNGFkZjlmYSIsImV4cCI6MTczMTAzMDU1Nywib3JpIjoiem9vbV9pcSIsImF1ZCI6InpmcyIsImlhdCI6MTcyOTczNDU1NywiaXNzIjoiZmlsZSJ9.J7dpq3w9T6qI8US6Xy74ewUvl521tOORsmejM_Yq8eqgJ_KA65p8tYwViSPvu4BygZWZLBiEHsKyPCgChFRj6w&mode=play"}},"transcript_body":{"type":"object","properties":{"meeting_id":{"type":"string","description":"The meeting ID.","example":"VgKcwkLoTPy80OyNcUo2Yg"},"account_id":{"type":"string","description":"The account ID.","example":"VgryoPBNR6uWYfyJqu4JFQ"},"host_id":{"type":"string","description":"The host ID.","example":"ycEUjKmDSnuPwF33KLTxJg"},"recording_start":{"type":"string","description":"The recording start date, in `yyyy-MM-dd'T'HH:mm:ss'Z'` format.","example":"2024-05-28T09:52:22Z"},"recording_end":{"type":"string","description":"The recording end date, in `yyyy-MM-dd'T'HH:mm:ss'Z'` format.","example":"2024-05-28T10:00:47Z"},"language":{"type":"string","description":"The primary language.","example":"en"},"speakers":{"maxItems":100,"type":"array","description":"The speaker's infomation.","items":{"required":["email_address","role","speaker_id","username","zoom_user_id"],"type":"object","properties":{"speaker_id":{"type":"string","description":"The speaker's sequence ID generated from Transcript Service.","example":"0"},"zoom_user_id":{"type":"string","description":"The speaker's user ID.","example":"ycEUjKmDSnuPwF33KLTxJg"},"email_address":{"type":"string","description":"The speaker's email address, this value is null for external users.","example":"cci_dev_admin@example.com"},"username":{"type":"string","description":"The speaker's username.","example":"Admin3"},"role":{"type":"string","description":"The speaker's role.","example":"rep","enum":["rep","customer"]}},"description":"The speaker's infomation."}},"items":{"maxItems":2000,"type":"array","description":"The text items.","items":{"type":"object","properties":{"comments":{"type":"string","description":"The comments.","example":"abc"},"item_id":{"type":"string","description":"The item's sequence ID, starting from 0.","example":"0"},"speaker_id":{"type":"string","description":"The speaker's sequence ID generated from Transcript Service.","example":"0"},"zoom_user_id":{"type":"string","description":"The speaker's user ID.","example":"ycEUjKmDSnuPwF33KLTxJg"},"start_time":{"type":"string","description":"The speak start time.","example":"00:00:22.790"},"end_time":{"type":"string","description":"The speak end time.","example":"00:00:25.680"},"text":{"type":"string","description":"The speech content.","example":"A halo, Kanji, this"},"email":{"type":"string","description":"The speaker's email address, this value is null for external users.","example":"cci_dev_admin@example.com"}}}}},"description":"The transcript content."},"language":{"type":"string","description":"The primary language.","example":"en"},"interaction_summary":{"type":"string","description":"The interaction's overall summary.","example":"The meeting involved a diverse range of unrelated exchanges among participants including Admin3 and an unnamed person identified as +12053546173. Topics touched upon, albeit discontinuously, revolved around a possible analytical recording concept, a potential interest in women, and a reference to monthly recording. Nevertheless, the specifics and the central objective of these discussions remained unclear from the provided transcript."},"interaction_info":{"required":["interaction_id"],"type":"object","properties":{"from":{"type":"string","description":"The caller's phone number in E.164 format.","example":"+12053546173"},"to":{"type":"string","description":"The recipient's phone number in E.164 format.","example":"+12095422197"},"interaction_id":{"type":"string","description":"The interaction ID.","example":"VgKcwkLoTPy80OyNcUo2Yg"},"agent_name":{"type":"string","description":"The agent's name.","example":"Admin3"},"consumer_name":{"type":"string","description":"The consumer's name.","example":"+12053546173"},"channel_type":{"type":"string","description":"The channel type, including `VIDEO`, `MANUAL`, `SMS`, `AUDIO` and `WEB_CHAT`.","example":"VIDEO","enum":["VIDEO","MANUAL","SMS","AUDIO","WEB_CHAT"]},"evaluator_name":{"type":"string","description":"The evaluator's name.","example":"Admin3","deprecated":true},"scorecard_name":{"type":"string","description":"The scorecard name.","example":"123","deprecated":true},"scorecard_id":{"type":"string","description":"The scorecard ID.","example":"C1SWkGmQSZG37RVL12vrsg","deprecated":true},"evaluator_user_id":{"type":"string","description":"The evaluator's user ID.","example":"ycEUjKmDSnuPwF33KLTxJg","deprecated":true},"evaluation_score":{"type":"number","description":"The evaluation score.","example":20,"deprecated":true},"evaluations":{"type":"array","description":"The associated evaluations.","items":{"type":"object","properties":{"evaluation_id":{"type":"string","description":"The evaluation ID.","example":"aI9HM3ZsEScAa"},"evaluation_type":{"type":"string","description":"The evaluation type.","example":"Automated","enum":["Manual","Automated"]},"evaluation_status_desc":{"type":"string","description":"For automatic scoring, the enumeration values ​​are `COMPLETED`, `PROCESSING`, and `FAILED`. For manual scoring, the enumeration values ​​are `Active`, `Completed`, `Pending`, `Expired`, and `Canceled`.","example":"Completed","enum":["COMPLETED","PROCESSING","FAILED","Active","Completed","Pending","Expired","Canceled"]},"session_id":{"type":"string","description":"The unique session ID for this evaluation.","example":"abc123def456"},"score":{"type":"number","description":"The actual score achieved in this evaluation.","example":85},"total_score":{"type":"number","description":"The maximum possible score for this evaluation.","example":60},"score_rate":{"type":"number","description":"The score rate, as a decimal. `Score`/`total_score` for points format, or the score itself for percentage format.","example":0.855},"scoring_format":{"type":"string","description":"The scoring format type.","example":"points","enum":["percentage","points"]},"evaluator_id":{"type":"string","description":"The unique user ID of the evaluator who performed the manual evaluation. Only present for manual evaluations.","example":"u_abc123xyz"},"evaluator_name":{"type":"string","description":"The display name of the evaluator who performed the manual evaluation. Only present for manual evaluations.","example":"Sarah Johnson"},"section_comments":{"type":"array","description":"Comments provided for each section in the scorecard evaluation.","items":{"type":"object","properties":{"section_id":{"type":"string","description":"The unique identifier of the scorecard section.","example":"sec_001"},"section_name":{"type":"string","description":"The name/title of the scorecard section","example":"Opening & Greeting"},"comment_text":{"type":"string","description":"The evaluator's comment text for this section.","example":"Excellent rapport building and professional tone throughout the opening."}},"description":"Section comment object containing the section information and comment details."}},"question_comments":{"type":"array","description":"Comments provided for each question or item in the scorecard evaluation.","items":{"type":"object","properties":{"question_id":{"type":"string","description":"The scorecard question's or item's unique identifier.","example":"q_001"},"question_title":{"type":"string","description":"The scorecard question's title or text.","example":"Did the agent properly identify themselves?"},"comment_text":{"type":"string","description":"The evaluator's comment text for this question.","example":"Agent clearly stated their name and company at the beginning."},"comment_time":{"type":"number","description":"The timestamp in seconds, from the start of the recording where this comment applies. Useful for linking comments to specific moments in the interaction.","example":15}},"description":"Question comment object containing the question information and comment details."}},"evaluation_name":{"type":"string","description":"The name of the scorecard used for this evaluation.","example":"Customer Service Quality Scorecard"}},"description":"Evaluate array."}},"associated_ids":{"maxItems":100,"type":"array","description":"The associated interaction IDs.","items":{"type":"string","description":"The associated interaction ID.","example":"VgKcwkLoTPy80OyNcUo2Yg"}}},"description":"The interaction infomation."},"screen_recording_status":{"type":"string","description":"The interaction screen recording's status.","example":"UNAVAILABLE","enum":["UNAVAILABLE","AVAILABLE","DELETED"]},"engagement_id":{"type":"string","description":"The engagement ID.","example":"2R1t8QtiTsKIOIAV0-a7FQ"},"silence_events":{"maxItems":100,"type":"array","description":"The silence event infomation.","items":{"type":"object","properties":{"start_time":{"type":"string","description":"The silence event start time.","example":"00:01:07.580"},"end_time":{"type":"string","description":"The silence event end time.","example":"00:01:10.960"}}}},"crosstalk_events":{"maxItems":100,"type":"array","description":"The crosstalk event infomation.","items":{"type":"object","properties":{"start_time":{"type":"string","description":"The crosstalk event start time.","example":"00:01:07.580"},"end_time":{"type":"string","description":"The crosstalk event end time.","example":"00:01:10.960"}}}},"hold_events":{"maxItems":100,"type":"array","description":"The crosstalk event infomation.","items":{"type":"object","properties":{"start_time":{"type":"string","description":"The hold event start time.","example":"00:01:07.580"},"end_time":{"type":"string","description":"The hold event end time.","example":"00:01:10.960"}}}},"direction":{"type":"string","description":"The direction.","example":"inbound"},"analysis":{"type":"object","properties":{"topics":{"maxItems":20,"type":"array","description":"Array of topics identified in the interaction content.","items":{"type":"object","properties":{"topic_name":{"type":"string","description":"The topic name.","example":"Customer Complaint"},"type":{"type":"string","description":"`predefined` for a custom topic defined by an account, or 'discovered' such as an AI generated topic.","example":"predefined","enum":["predefined","discovered"]}},"description":"A specific topic in the interaction."}},"indicators":{"maxItems":250,"type":"array","description":"Array of indicators detected in the interaction.","items":{"type":"object","properties":{"indicator_name":{"type":"string","description":"The indicator name.","example":"Hello"}},"description":"A specific indicator in the interaction."}},"next_steps":{"maxItems":20,"type":"array","description":"Array of recommended actions or follow-up steps based on the analysis of the interaction content.","items":{"type":"object","properties":{"next_step":{"type":"string","description":"The next step or action.","example":"Jasper: Contact the billing department to pay malpractice premium without policy number"}},"description":"A specific recommended action or next step."}},"good_questions":{"maxItems":20,"type":"array","description":"Array of effective questions that were asked during the interaction.","items":{"type":"object","properties":{"good_question":{"type":"string","description":"The good question.","example":"I'm really sorry to hear that. Could you please describe the issue you’re experiencing? We’d like to help resolve it as soon as possible."}},"description":"A specific good question in the interaction."}}},"description":"AI-powered analysis of the interaction content."}},"description":"The response"}}}},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  Unauthorized. \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  Not found. \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_authorization":[]}],"x-extensions":{"x-permissions":["AllInteractions:Read"],"x-macro-scopes":["qm_interactions:read:admin","qm_interactions:read"],"x-granular-scopes":["zoom_quality_management:read:interactions","zoom_quality_management:read:interactions:admin"]}}}},"components":{"securitySchemes":{"openapi_authorization":{"scheme":"bearer","type":"http"}}},"tags":[{"name":"Calibrations"},{"name":"Cases"},{"name":"Evaluations"},{"name":"Interactions"}]}