v52

OpenAPI 3.1.0raw.githubusercontent.com2026-07-311,1941,9384.1 MB

Conference Commands

List conferences

Lists conferences. Conferences are created on demand, and will expire after all participants have left the conference or after 4 hours regardless of the number of active participants. Conferences are listed in descending order by expires_at.

get/conferences

Query parameters

region'Australia' | 'Europe' | 'Middle East' | 'US'

Region where the conference data is located

application_session_idstring uuid

The unique identifier of the call session. A session may include multiple call leg events.

connection_idstring

The unique identifier of the conection.

failedboolean

Delivery failed or not.

fromstring

Filter by From number.

leg_idstring uuid

The unique identifier of an individual call leg.

namestring

If present, conferences will be filtered to those with a matching name attribute. Matching is case-sensitive

outbound.outbound_voice_profile_idstring

Identifies the associated outbound voice profile.

product'call_control' | 'fax' | 'texml'

Filter by product.

status'init' | 'in_progress' | 'completed'

If present, conferences will be filtered by status.

tostring

Filter by To number.

type'command' | 'webhook'

Event type

Consolidated filter parameter (deepObject style). Originally: filter[application_name][contains], filter[outbound.outbound_voice_profile_id], filter[leg_id], filter[application_session_id], filter[connection_id], filter[product], filter[failed], filter[from], filter[to], filter[name], filter[type], filter[occurred_at][eq/gt/gte/lt/lte], filter[status]

{
  "from": "+12025550142",
  "occurred_at": {
    "eq": "2019-03-29T11:10:00Z",
    "gt": "2019-03-29T11:10:00Z",
    "gte": "2019-03-29T11:10:00Z",
    "lt": "2019-03-29T11:10:00Z",
    "lte": "2019-03-29T11:10:00Z"
  },
  "outbound.outbound_voice_profile_id": "1293384261075731499",
  "product": "texml",
  "to": "+12025550142",
  "type": "webhook"
}

afterstring

Opaque identifier of next page

beforestring

Opaque identifier of previous page

limitinteger

Limit of records per single page

numberinteger

The page number to load

sizeinteger

The size of the page

Consolidated page parameter (deepObject style). Originally: page[after], page[before], page[limit], page[size], page[number]

Response

Successful response with a list of conferences.

Example response

{
  "data": [
    {
      "connection_id": "3fa85f64-9191-4567-b3fc-2c963f66afa6",
      "created_at": "2019-01-23T18:10:02.574Z",
      "end_reason": "all_left",
      "ended_by": {
        "call_control_id": "v2:T02llQxIyaRkhfRKxgAP8nY511EhFLizdvdUKJiSw8d6A9BborherQczRrZvZakpWxBlpw48KyZQ==",
        "call_session_id": "428c31b6-abf3-3bc1-b7f4-5013ef9657c1"
      },
      "expires_at": "2019-01-23T18:10:02.574Z",
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "All hands meeting",
      "record_type": "conference",
      "region": "sv1",
      "status": "completed",
      "updated_at": "2019-01-23T18:10:02.574Z"
    }
  ],
  "meta": {
    "page_number": 2,
    "page_size": 25,
    "total_pages": 3,
    "total_results": 55
  }
}