Retrieve a list of Conferences
TODO: Resource-level docs
Retrieve a list of Conferences.
Query parameters
-
ConferenceSid string
The SID of the conference.
-
FriendlyName string
Custom label for the conference resource, up to 64 characters.
-
Status string
Conference status.
-
CreatedAfter string
Conferences created after the provided timestamp specified in ISO 8601 format
-
CreatedBefore string
Conferences created before the provided timestamp specified in ISO 8601 format.
-
MixerRegion string
Twilio region where the conference media was mixed.
-
Subaccount string
Account SID for the subaccount whose resources you wish to retrieve.
-
DetectedIssues string
Potential configuration, behavior, or performance issues detected during the conference.
-
EndReason string
Conference end reason; e.g. last participant left, modified by API, etc.
-
PageSize integer
How many resources to return in each list page. The default is 50, and the maximum is 1000.
Minimum value is
1
, maximum value is1000
.
GET /v1/Conferences
curl \
-X GET https://insights.twilio.com/v1/Conferences \
--user "username:password"
Response examples (200)
{
"conferences": [
{
"account_sid": "string",
"conference_sid": "string",
"connect_duration_seconds": 42,
"create_time": "2023-05-04T09:42:00+00:00",
"duration_seconds": 42,
"end_reason": "last_participant_left",
"end_time": "2023-05-04T09:42:00+00:00",
"ended_by": "string",
"friendly_name": "string",
"links": {},
"max_concurrent_participants": 42,
"max_participants": 42,
"mixer_region": "us1",
"mixer_region_requested": "us1",
"processing_state": "complete",
"recording_enabled": true,
"start_time": "2023-05-04T09:42:00+00:00",
"status": "in_progress",
"tags": [
"invalid_requested_region"
],
"unique_participants": 42,
"url": "https://example.com"
}
],
"meta": {
"first_page_url": "https://example.com",
"key": "string",
"next_page_url": "https://example.com",
"page": 42,
"page_size": 42,
"previous_page_url": "https://example.com",
"url": "https://example.com"
}
}
Response examples (200)
{
"conferences": [
{
"account_sid": "string",
"conference_sid": "string",
"connect_duration_seconds": 42,
"create_time": "2024-05-04T09:42:00+00:00",
"duration_seconds": 42,
"end_reason": "last_participant_left",
"end_time": "2024-05-04T09:42:00+00:00",
"ended_by": "string",
"friendly_name": "string",
"links": {},
"max_concurrent_participants": 42,
"max_participants": 42,
"mixer_region": "us1",
"mixer_region_requested": "us1",
"processing_state": "complete",
"recording_enabled": true,
"start_time": "2024-05-04T09:42:00+00:00",
"status": "in_progress",
"tags": [
"invalid_requested_region"
],
"unique_participants": 42,
"url": "https://example.com"
}
],
"meta": {
"first_page_url": "https://example.com",
"key": "string",
"next_page_url": "https://example.com",
"page": 42,
"page_size": 42,
"previous_page_url": "https://example.com",
"url": "https://example.com"
}
}