---
title: "List room session recordings"
method: GET
path: "/api/video/room_sessions/{id}/recordings"
tags: ["Room Sessions"]
---

# List room session recordings

`GET /api/video/room_sessions/{id}/recordings`

A list of Room Recordings for a particular Room Session.

#### Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Video_.

[Learn more about API scopes](/docs/platform/your-signalwire-api-space).

## Path parameters

- `id` string, uuid, required — Universal Unique Identifier.

## Query parameters

- `media_ttl` integer
- `page_number` integer
- `page_size` integer
- `page_token` string

## Response `200`

The request has succeeded.

- VideoListRoomSessionRecordingsResponse — List room session recordings response.
  - `links` VideoPaginationLinks, required — Pagination links for list responses.
    - `self` string, required — Link to the current page.
    - `first` string, required — Link to the first page.
    - `next` string — Link to the next page.
    - `prev` string — Link to the previous page.
  - `data` VideoRoomRecording[], required — List of room recordings.
    - `id` string, uuid, required — Universal Unique Identifier.
    - `room_session_id` string, uuid, required — Universal Unique Identifier.
    - `status` 'recording' | 'paused' | 'processing' | 'completed', required — Status of a room recording.
    - `started_at` string, date-time, nullable, required — Timestamp of when the Room Recording started.
    - `finished_at` string, date-time, nullable, required — Timestamp of when the Room Recording stopped.
    - `duration` integer, nullable, required — The length of the Room Recording in seconds.
    - `size_in_bytes` integer, nullable, required — The number of bytes of the Room Recording file.
    - `format` string, nullable, required — The MIME type of the Room Recording file.
    - `cost_in_dollars` number, double, required — The cost of the recording in dollars.
    - `uri` string, nullable, required — A temporary URL for accessing the recording file. By default, valid for 15 minutes.
    - `created_at` string, date-time, required — Timestamp when the recording was created.
    - `updated_at` string, date-time, required — Timestamp when the recording was last updated.

## Other responses

- `400` — The request is invalid.
- `401` — Access is unauthorized.
- `422` — The request contains invalid parameters. See errors for details.
- `500` — An internal server error occurred.

---

[API](https://skmtc.net/signalwire/apis/signalwire-rest-api.md) · [All operations](https://skmtc.net/signalwire/apis/signalwire-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/signalwire/signalwire-rest-api/revisions/7a9eb5f67855/schema)