Conference Summary Resource
Fetch a Conference Summary
The Conference Summary resource provides an overview of metadata and quality metrics for a single conference. A completed conference summary may take up to 30 minutes to generate following the end of the conference.
GET https://insights.twilio.com/v1/Conferences/{Conference_SID}
| Resource Properties in REST API format | |
|---|---|
conference_sid
|
The unique SID identifier of the Conference. |
account_sid
|
The unique SID identifier of the Account. |
friendly_name
|
Custom label for the conference resource, up to 64 characters. |
create_time
|
Conference creation date and time in ISO 8601 format. |
start_time
|
Timestamp in ISO 8601 format when the conference started. Conferences do not start until at least two participants join, at least one of whom has startConferenceOnEnter=true. |
end_time
|
Conference end date and time in ISO 8601 format. |
duration_seconds
|
Conference duration in seconds. |
connect_duration_seconds
|
Duration of the between conference start event and conference end event in seconds. |
status
|
Status of this Conference; |
max_participants
|
Maximum number of concurrent participants as specified by the configuration. |
max_concurrent_participants
|
Actual maximum number of concurrent participants in the conference. |
unique_participants
|
Unique conference participants based on caller ID. |
end_reason
|
Conference end reason; e.g. last participant left, modified by API, etc. |
ended_by
|
Call SID of the participant whose actions ended the conference. |
mixer_region
|
Twilio region where the conference media was mixed. |
mixer_region_requested
|
Twilio region where conference mixed was specified to be mixed in configuration. |
recording_enabled
|
Boolean. Indicates whether recording was enabled at the conference mixer. |
detected_issues
|
Potential issues detected by Twilio during the conference. |
tags
|
Tags for detected conference conditions and participant behaviors which may be of interest. |
tag_info
|
Object. Contains details about conference tags including severity. |
processing_state
|
Processing state for the Conference Summary resource. Will be |
url
|
The URL of this resource. |
links
|
Contains a dictionary of URL links to nested resources of this Conference. |
Read multiple Conference Summary resources
The Conference Summary list API allows results to be filtered by date, friendly name, region, and other dimensions. By default, the Conference Summary list API returns a list of conferences hosted in the last 24 hours. To read multiple Conference Summaries of Conferences hosted prior to the last 24 hours, specify the CreatedAfter and/or CreatedBefore query params.
| Parameters in REST API format | |
|---|---|
conference_sid
Optional
|
The SID of the conference. |
friendly_name
Optional
|
Custom label for the conference resource, up to 64 characters. |
status
Optional
|
Conference status. |
created_after
Optional
|
Conferences created after the provided timestamp specified in ISO 8601 format |
created_before
Optional
|
Conferences created before the provided timestamp specified in ISO 8601 format. |
mixer_region
Optional
|
Twilio region where the conference media was mixed. |
tags
Optional
|
Tags applied by Twilio for common potential configuration, quality, or performance issues. |
subaccount
Optional
|
Account SID for the subaccount whose resources you wish to retrieve. |
detected_issues
Optional
|
Potential configuration, behavior, or performance issues detected during the conference. |
end_reason
Optional
|
Conference end reason; e.g. last participant left, modified by API, etc. |
GET https://insights.twilio.com/v1/Conferences
Need some help?
We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.
