---
title: "Retrieve a conference"
method: GET
path: "/conferences/{id}"
tags: ["Conference Commands"]
---

# Retrieve a conference

`GET /conferences/{id}`

Retrieve an existing conference

## Path parameters

- `id` string, required

## Query parameters

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

## Response `200`

Successful response with details about a conference.

- 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

## Other responses

- `404` — Resource not found. The requested resource does not exist. Common causes include: invalid call_control_id, conference not found, audio file not found, or recording not found.

---

[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/versions/8f5f4e537994/schema)