---
title: "Get room recording"
method: GET
path: "/api/video/room_recordings/{id}"
tags: ["Room Recordings"]
---

# Get room recording

`GET /api/video/room_recordings/{id}`

Retrieves one Video Room recording by ID and returns a media link with the requested lifetime. Use it when you saved a recording ID or selected one from a recording list; voice-call recordings are available through the [Recordings API](/docs/apis/rest/recordings/list-call-recordings) instead.

#### 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

## Response `200`

Room recording response.

- VideoRoomRecording — Room recording response object.
  - `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.
- `404` — The server cannot find the requested resource.
- `422` — The request contains invalid parameters. See errors for details.
- `500` — An internal server error occurred.

---

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