--- title: "List of all Recording compositions." method: GET path: "/v1/Compositions" tags: ["VideoV1Composition"] --- # List of all Recording compositions. `GET /v1/Compositions` List of all Recording compositions. ## Query parameters - `Status` 'enqueued' | 'processing' | 'completed' | 'deleted' | 'failed' — The status of the composition. Can be: `enqueued`, `processing`, `completed`, `deleted` or `failed`. `enqueued` is the initial state and indicates that the composition request has been received and is scheduled for processing; `processing` indicates the composition is being processed; `completed` indicates the composition has been completed and is available for download; `deleted` means the composition media has been deleted from the system, but its metadata is still available for 30 days; `failed` indicates the composition failed to execute the media processing task. - `DateCreatedAfter` string, date-time - `DateCreatedBefore` string, date-time - `RoomSid` string - `PageSize` integer - `Page` integer - `PageToken` string ## Response `200` OK - object - `compositions` VideoV1Composition[] - `account_sid` string, nullable — The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Composition resource. - `status` 'enqueued' | 'processing' | 'completed' | 'deleted' | 'failed' — The status of the composition. Can be: `enqueued`, `processing`, `completed`, `deleted` or `failed`. `enqueued` is the initial state and indicates that the composition request has been received and is scheduled for processing; `processing` indicates the composition is being processed; `completed` indicates the composition has been completed and is available for download; `deleted` means the composition media has been deleted from the system, but its metadata is still available for 30 days; `failed` indicates the composition failed to execute the media processing task. - `date_created` string, date-time, nullable — The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. - `date_completed` string, date-time, nullable — The date and time in GMT when the composition's media processing task finished, specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. - `date_deleted` string, date-time, nullable — The date and time in GMT when the composition generated media was deleted, specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. - `sid` string, nullable — The unique string that we created to identify the Composition resource. - `room_sid` string, nullable — The SID of the Group Room that generated the audio and video tracks used in the composition. All media sources included in a composition must belong to the same Group Room. - `audio_sources` string[], nullable — The array of track names to include in the composition. The composition includes all audio sources specified in `audio_sources` except those specified in `audio_sources_excluded`. The track names in this property can include an asterisk as a wild card character, which matches zero or more characters in a track name. For example, `student*` includes tracks named `student` as well as `studentTeam`. - `audio_sources_excluded` string[], nullable — The array of track names to exclude from the composition. The composition includes all audio sources specified in `audio_sources` except for those specified in `audio_sources_excluded`. The track names in this property can include an asterisk as a wild card character, which matches zero or more characters in a track name. For example, `student*` excludes `student` as well as `studentTeam`. This parameter can also be empty. - `video_layout` unknown - `resolution` string, nullable — The dimensions of the video image in pixels expressed as columns (width) and rows (height). The string's format is `{width}x{height}`, such as `640x480`. - `trim` boolean, nullable — Whether to remove intervals with no media, as specified in the POST request that created the composition. Compositions with `trim` enabled are shorter when the Room is created and no Participant joins for a while as well as if all the Participants leave the room and join later, because those gaps will be removed. See [Specifying Video Layouts](https://www.twilio.com/docs/video/api/compositions-resource#specifying-video-layouts) for more info. - `format` 'mp4' | 'webm' — The container format of the composition's media files as specified in the POST request that created the Composition resource. See [POST Parameters](https://www.twilio.com/docs/video/api/compositions-resource#http-post-parameters) for more information. - `bitrate` integer — The average bit rate of the composition's media. - `size` integer, nullable — The size of the composed media file in bytes. - `duration` integer — The duration of the composition's media file in seconds. - `media_external_location` string, uri, nullable — The URL of the media file associated with the composition when stored externally. See [External S3 Compositions](/docs/video/api/external-s3-compositions) for more details. - `status_callback` string, uri, nullable — The URL called using the `status_callback_method` to send status information on every composition event. - `status_callback_method` 'GET' | 'POST', http-method, nullable — The HTTP method used to call `status_callback`. Can be: `POST` or `GET`, defaults to `POST`. - `url` string, uri, nullable — The absolute URL of the resource. - `links` object, nullable — The URL of the media file associated with the composition. - `meta` object - `first_page_url` string, uri - `key` string - `next_page_url` string, uri, nullable - `page` integer - `page_size` integer - `previous_page_url` string, uri, nullable - `url` string, uri --- [API](https://skmtc.net/twilio/apis/video-v1.md) · [All operations](https://skmtc.net/twilio/apis/video-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twilio/video-v1/versions/162f62d432a2/schema)