---
title: "View a room composition."
method: GET
path: "/room_compositions/{room_composition_id}"
tags: ["Room Compositions"]
---

# View a room composition.

`GET /room_compositions/{room_composition_id}`

## Path parameters

- `room_composition_id` string, uuid, required

## Response `200`

Get room composition response.

- object
  - `data` RoomComposition
    - `id` string, uuid — A unique identifier for the room composition.
    - `room_id` string, uuid — Identify the room associated with the room composition.
    - `session_id` string, uuid — Identify the room session associated with the room composition.
    - `user_id` string, uuid — Identify the user associated with the room composition.
    - `status` 'completed' | 'enqueued' | 'processing' — Shows the room composition status.
    - `size_mb` number, float — Shows the room composition size in MB.
    - `download_url` string — Url to download the composition.
    - `duration_secs` integer — Shows the room composition duration in seconds.
    - `format` 'mp4' — Shows format of the room composition.
    - `created_at` string, date-time — ISO 8601 timestamp when the room composition was created.
    - `updated_at` string, date-time — ISO 8601 timestamp when the room composition was updated.
    - `ended_at` string, date-time — ISO 8601 timestamp when the room composition has ended.
    - `started_at` string, date-time — ISO 8601 timestamp when the room composition has stated.
    - `completed_at` string, date-time — ISO 8601 timestamp when the room composition has completed.
    - `video_layout` object — Describes the video layout of the room composition in terms of regions. Limited to 2 regions.
    - `webhook_event_url` string, uri — The URL where webhooks related to this room composition will be sent. Must include a scheme, such as 'https'.
    - `webhook_event_failover_url` string, uri — The failover URL where webhooks related to this room composition will be sent if sending to the primary URL fails. Must include a scheme, such as 'https'.
    - `webhook_timeout_secs` integer — Specifies how many seconds to wait before timing out a webhook.
    - `resolution` string — The resolution of the room composition.
    - `record_type` string

## Other responses

- `404` — Resource 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)