List conversations
GET {{baseUrl}}/iq/conversations?host_id=<string>&participant_id=<string>&team_id=<string>&deal_id=<string>&period_type=meetingStartTime&from=<string>&to=<string>&conversation_type=all&callout_type=engagingQuestions&indicator_id=<string>&mentioned_topic_id=<string>&scored=<boolean>&page_size=30&next_page_token=<string>
List all conversations.
Scopes: iq_conversation:read:admin,iq_conversation:read
Rate Limit Label: MEDIUM
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
host_id | string | The host user ID to query. | |
participant_id | string | The internal participant ID to query. | |
team_id | string | The Zoom specific team ID to query. | |
deal_id | string | The Zoom specific deal ID to query. | |
period_type | string | The type of period to query: |
meetingStartTime— Queries conversations with meeting_start_time in the time period between the From and To parameters.iqProcessedTime— Queries conversations with iq_processed_time in the time period between the From and To parameters. | |from| string | | The start date inyyyy-MM-dd'T'HH:mm:ss'Z'format. | |to| string | | The end date inyyyy-MM-dd'T'HH:mm:ss'Z'format. | |conversation_type| string | | The type of conversations to query:all— All conversations.meeting— Meeting conversations.phone- Phone conversations. | |callout_type| string | | The callout type of conversations to query:engagingQuestions— Only query conversations that include engaging questions indicator.nextSteps— Only query conversations that include next steps indicator. | |indicator_id| string | | The indicator id to query. | |mentioned_topic_id| string | | The mentioned topic id to query. | |scored| string | | Set totrueto return scored conversations from the conversation list. | |page_size| number | | The number of records returned within a single API call. | |next_page_token| string | | The next page token is used to paginate through large result sets. A next page token will be returned whenever the set of available results exceeds the current page size. The expiration period for this token is 15 minutes. |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"next_page_token":"\u003cstring\u003e","page_size":30,"conversations":[{"conversation_id":"\u003cstring\u003e","host_id":"\u003cstring\u003e","meeting_id":"\u003clong\u003e","meeting_uuid":"\u003cstring\u003e","deal_id":"\u003cstring\u003e","topic":"\u003cstring\u003e","conversation_topic":"\u003cstring\u003e","duration":"\u003cinteger\u003e","conversation_type":"\u003cstring\u003e","meeting_start_time":"\u003cstring\u003e","iq_processed_time":"\u003cstring\u003e","engagement_score":"\u003cinteger\u003e","sentiment_score":"\u003cinteger\u003e","engaging_questions_count":"\u003cinteger\u003e","next_steps_count":"\u003cinteger\u003e","filler_words_count":"\u003cinteger\u003e","processing_analysis":"\u003cboolean\u003e"},{"conversation_id":"\u003cstring\u003e","host_id":"\u003cstring\u003e","meeting_id":"\u003clong\u003e","meeting_uuid":"\u003cstring\u003e","deal_id":"\u003cstring\u003e","topic":"\u003cstring\u003e","conversation_topic":"\u003cstring\u003e","duration":"\u003cinteger\u003e","conversation_type":"\u003cstring\u003e","meeting_start_time":"\u003cstring\u003e","iq_processed_time":"\u003cstring\u003e","engagement_score":"\u003cinteger\u003e","sentiment_score":"\u003cinteger\u003e","engaging_questions_count":"\u003cinteger\u003e","next_steps_count":"\u003cinteger\u003e","filler_words_count":"\u003cinteger\u003e","processing_analysis":"\u003cboolean\u003e"}]}