---
title: "View a list of room recordings."
method: GET
path: "/room_recordings"
tags: ["Room Recordings"]
---

# View a list of room recordings.

`GET /room_recordings`

## Query parameters

- `filter` object
  - `date_ended_at` object
    - `eq` string, date — ISO 8601 date for filtering room recordings ended on that date.
    - `gte` string, date — ISO 8601 date for filtering room recordings ended on or after that date.
    - `lte` string, date — ISO 8601 date for filtering room recordings ended on or before that date.
  - `date_started_at` object
    - `eq` string, date — ISO 8601 date for filtering room recordings started on that date.
    - `gte` string, date — ISO 8601 date for filtering room recordings started on or after that date.
    - `lte` string, date — ISO 8601 date for filtering room recordings started on or before that date.
  - `room_id` string, uuid — room_id for filtering room recordings.
  - `participant_id` string, uuid — participant_id for filtering room recordings.
  - `session_id` string, uuid — session_id for filtering room recordings.
  - `status` string — status for filtering room recordings.
  - `type` string — type for filtering room recordings.
  - `duration_secs` integer — duration_secs greater or equal for filtering room recordings.
- `page` object
  - `size` integer — The size of the page.
  - `number` integer — The page number to load.

## Response `200`

List room recordings response.

- object
  - `data` RoomRecording[]
    - `id` string, uuid — A unique identifier for the room recording.
    - `room_id` string, uuid — Identify the room associated with the room recording.
    - `session_id` string, uuid — Identify the room session associated with the room recording.
    - `participant_id` string, uuid — Identify the room participant associated with the room recording.
    - `status` 'completed' | 'processing' — Shows the room recording status.
    - `type` 'audio' | 'video' — Shows the room recording type.
    - `size_mb` number, float — Shows the room recording size in MB.
    - `download_url` string — Url to download the recording.
    - `codec` string — Shows the codec used for the room recording.
    - `duration_secs` integer — Shows the room recording duration in seconds.
    - `created_at` string, date-time — ISO 8601 timestamp when the room recording was created.
    - `updated_at` string, date-time — ISO 8601 timestamp when the room recording was updated.
    - `ended_at` string, date-time — ISO 8601 timestamp when the room recording has ended.
    - `started_at` string, date-time — ISO 8601 timestamp when the room recording has stated.
    - `completed_at` string, date-time — ISO 8601 timestamp when the room recording has completed.
    - `record_type` string
  - `meta` PaginationMeta
    - `total_pages` integer
    - `total_results` integer
    - `page_number` integer
    - `page_size` integer

## Other responses

- `4XX` — Unexpected error

---

[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)