---
title: "List conferences"
method: GET
path: "/conferences"
tags: ["Conference Commands"]
---

# List conferences

`GET /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`.

## Query parameters

- `region` 'Australia' | 'Europe' | 'Middle East' | 'US'
- `filter` object
  - `application_name` object — Application name filters
    - `contains` string — If present, applications with <code>application_name</code> containing the given value will be returned. Matching is not case-sensitive. Requires at least three characters.
  - `outbound.outbound_voice_profile_id` string — Identifies the associated outbound voice profile.
  - `leg_id` string, uuid — The unique identifier of an individual call leg.
  - `application_session_id` string, uuid — The unique identifier of the call session. A session may include multiple call leg events.
  - `connection_id` string — The unique identifier of the conection.
  - `product` 'call_control' | 'fax' | 'texml' — Filter by product.
  - `failed` boolean — Delivery failed or not.
  - `from` string — Filter by From number.
  - `to` string — Filter by To number.
  - `name` string — If present, conferences will be filtered to those with a matching `name` attribute. Matching is case-sensitive
  - `type` 'command' | 'webhook' — Event type
  - `occurred_at` object — Event occurred_at filters
    - `eq` string — Event occurred_at: equal
    - `gt` string — Event occurred_at: greater than
    - `gte` string — Event occurred_at: greater than or equal
    - `lt` string — Event occurred_at: lower than
    - `lte` string — Event occurred_at: lower than or equal
  - `status` 'init' | 'in_progress' | 'completed' — If present, conferences will be filtered by status.
- `page` object
  - `after` string — Opaque identifier of next page
  - `before` string — Opaque identifier of previous page
  - `limit` integer — Limit of records per single page
  - `size` integer — The size of the page
  - `number` integer — The page number to load

## Response `200`

Successful response with a list of conferences.

- object
  - `data` Conference[]
    - `record_type` 'conference', required
    - `id` string, required — Uniquely identifies the conference
    - `name` string, required — Name of the conference
    - `created_at` string, required — ISO 8601 formatted date of when the conference was created
    - `expires_at` string, required — ISO 8601 formatted date of when the conference will expire
    - `updated_at` string — ISO 8601 formatted date of when the conference was last updated
    - `region` string — Region where the conference is hosted
    - `status` 'init' | 'in_progress' | 'completed' — Status of the conference
    - `end_reason` 'all_left' | 'ended_via_api' | 'host_left' | 'time_exceeded' — Reason why the conference ended
    - `ended_by` object — IDs related to who ended the conference. It is expected for them to all be there or all be null
      - `call_control_id` string — Call Control ID which ended the conference
      - `call_session_id` string — Call Session ID which ended the conference
    - `connection_id` string — Identifies the connection associated with the conference
  - `meta` PaginationMeta
    - `total_pages` integer
    - `total_results` integer
    - `page_number` integer
    - `page_size` integer

## Other responses

- `401` — Unauthorized. Authentication failed - the required authentication headers were either invalid or not included in the request.
- `422` — Unprocessable entity. The request was well-formed but could not be processed due to semantic errors. This includes validation errors, invalid parameter values, call state errors, conference errors, queue errors, recording/transcription errors, and business logic violations.

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/8f5f4e537994/schema)