---
title: "List conference participants"
method: GET
path: "/conferences/{conference_id}/participants"
tags: ["Conference Commands"]
---

# List conference participants

`GET /conferences/{conference_id}/participants`

Lists conference participants

## Path parameters

- `conference_id` string, required

## Query parameters

- `region` 'Australia' | 'Europe' | 'Middle East' | 'US'
- `filter` object
  - `muted` boolean — If present, participants will be filtered to those who are/are not muted
  - `on_hold` boolean — If present, participants will be filtered to those who are/are not put on hold
  - `whispering` boolean — If present, participants will be filtered to those who are whispering or are not
- `page[number]` integer
- `page[size]` integer

## Response `200`

Successful response with a list of conference participants.

- object
  - `data` Participant[]
    - `record_type` 'participant', required
    - `id` string, required — Uniquely identifies the participant
    - `call_leg_id` string, required — Uniquely identifies the call leg associated with the participant
    - `call_control_id` string, required — Call Control ID associated with the partiipant of the conference
    - `conference` object, required — Info about the conference that the participant is in
      - `id` string — Uniquely identifies the conference
      - `name` string — Name of the conference
    - `whisper_call_control_ids` string[], required — Array of unique call_control_ids the participant can whisper to..
    - `created_at` string, required — ISO 8601 formatted date of when the participant was created
    - `updated_at` string, required — ISO 8601 formatted date of when the participant was last updated
    - `end_conference_on_exit` boolean, required — Whether the conference will end and all remaining participants be hung up after the participant leaves the conference.
    - `soft_end_conference_on_exit` boolean, required — Whether the conference will end after the participant leaves the conference.
    - `status` 'joining' | 'joined' | 'left', required — The status of the participant with respect to the lifecycle within the conference
    - `muted` boolean, required — Whether the participant is muted.
    - `on_hold` boolean, required — Whether the participant is put on_hold.
  - `meta` PaginationMeta
    - `total_pages` integer, required
    - `total_results` integer
    - `page_number` integer, required
    - `page_size` integer

## Other responses

- `401` — Unauthorized. Authentication failed - the required authentication headers were either invalid or not included in the request.
- `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.
- `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.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api/revisions/e32d46c5945b/schema)