Sign in

v50

latestOpenAPI 3.0.1Apache 2.0raw.githubusercontent.com2026-04-143933299.0 KB
VideoV1Recording

Returns a single Recording resource identified by a Recording SID.

Returns a single Recording resource identified by a Recording SID.

get/v1/Recordings/{Sid}

Path parameters

Sidstring required

The SID of the Recording resource to fetch.

Response

OK

account_sidstring nullable

The SID of the Account that created the Recording resource.

status'processing' | 'completed' | 'deleted' | 'failed'

The status of the recording. Can be: processing, completed, or deleted. processing indicates the recording is still being captured; completed indicates the recording has been captured and is now available for download. deleted means the recording media has been deleted from the system, but its metadata is still available.

date_createdstring date-time nullable

The date and time in GMT when the resource was created specified in ISO 8601 format.

sidstring nullable

The unique string that we created to identify the Recording resource.

source_sidstring nullable

The SID of the recording source. For a Room Recording, this value is a track_sid.

sizeinteger nullable

The size of the recorded track, in bytes.

urlstring uri nullable

The absolute URL of the resource.

type'audio' | 'video' | 'data'

The recording's media type. Can be: audio or video.

durationinteger nullable

The duration of the recording in seconds rounded to the nearest second. Sub-second tracks have a Duration property of 1 second

container_format'mka' | 'mkv'
codec'VP8' | 'H264' | 'OPUS' | 'PCMU'

The codec used to encode the track. Can be: VP8, H264, OPUS, and PCMU.

{"stackTrail":"components:schemas:video.v1.recording:properties:grouping_sids","oasType":"schema","type":"unknown","description":"A list of SIDs related to the recording. Includes the `room_sid` and `participant_sid`.","nullable":true}
track_namestring nullable

The name that was given to the source track of the recording. If no name is given, the source_sid is used.

offsetinteger nullable

The time in milliseconds elapsed between an arbitrary point in time, common to all group rooms, and the moment when the source room of this track started. This information provides a synchronization mechanism for recordings belonging to the same room.

media_external_locationstring uri nullable

The URL of the media file associated with the recording when stored externally. See External S3 Recordings for more details.

status_callbackstring uri nullable

The URL called using the status_callback_method to send status information on every recording 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.

linksobject nullable

The URLs of related resources.