Returns a single Recording resource identified by a Recording SID

GET /v1/Recordings/{Sid}

Single-track, single-media recordings

Returns a single Recording resource identified by a Recording SID.

Path parameters

  • Sid string Required

    The SID of the Recording resource to fetch.

Responses

  • OK

    Hide response attributes Show response attributes object
    • account_sid string | null

      The SID of the Account that created the resource

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AC[0-9a-fA-F]{32}$.

    • codec string | null

      The codec used to encode the track

      Values are VP8, H264, OPUS, or PCMU.

    • container_format string | null

      The file format for the recording

      Values are mka or mkv.

    • date_created string(date-time) | null

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

    • duration integer | null

      The duration of the recording in seconds

    • A list of SIDs related to the recording

    • media_external_location string(uri) | null

      The URL of the media file associated with the recording when stored externally

    • offset integer | null

      The number of milliseconds between a point in time that is common to all rooms in a group and when the source room of the recording started

    • sid string | null

      The unique string that identifies the resource

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^RT[0-9a-fA-F]{32}$.

    • size integer | null

      The size of the recorded track, in bytes

    • source_sid string | null

      The SID of the recording source

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^[a-zA-Z]{2}[0-9a-fA-F]{32}$.

    • status string | null

      The status of the recording

      Values are processing, completed, deleted, or failed.

    • status_callback string(uri) | null

      The URL called to send status information on every recording event.

    • status_callback_method string(http-method) | null

      The HTTP method used to call status_callback

      Values are HEAD, GET, POST, PATCH, PUT, or DELETE.

    • track_name string | null

      The name that was given to the source track of the recording

    • type string | null

      The recording's media type

      Values are audio, video, or data.

    • url string(uri) | null

      The absolute URL of the resource

GET /v1/Recordings/{Sid}
curl \
 -X GET https://video.twilio.com/v1/Recordings/{Sid} \
 --user "username:password"
Response examples (200)
{
  "account_sid": "string",
  "codec": "VP8",
  "container_format": "mka",
  "date_created": "2023-05-04T09:42:00+00:00",
  "duration": 42,
  "links": {},
  "media_external_location": "https://example.com",
  "offset": 42,
  "sid": "string",
  "size": 42,
  "source_sid": "string",
  "status": "processing",
  "status_callback": "https://example.com",
  "status_callback_method": "HEAD",
  "track_name": "string",
  "type": "audio",
  "url": "https://example.com"
}
Response examples (200)
{
  "account_sid": "string",
  "codec": "VP8",
  "container_format": "mka",
  "date_created": "2024-05-04T09:42:00+00:00",
  "duration": 42,
  "links": {},
  "media_external_location": "https://example.com",
  "offset": 42,
  "sid": "string",
  "size": 42,
  "source_sid": "string",
  "status": "processing",
  "status_callback": "https://example.com",
  "status_callback_method": "HEAD",
  "track_name": "string",
  "type": "audio",
  "url": "https://example.com"
}