TWtwilio
Api20100401Recording

Fetch an instance of a recording

Changed on

Fetch an instance of a recording

get/2010-04-01/Accounts/{AccountSid}/Recordings/{Sid}.json

Request

  • Base URL
    https://api.twilio.com
  • URL
    https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Recordings/{Sid}.json
  • Auth
    HTTP basic

Path parameters

AccountSidstring required

The SID of the Account that created the Recording resource to fetch.

Sidstring required

The Twilio-provided string that uniquely identifies the Recording resource to fetch.

Query parameters

IncludeSoftDeletedboolean

A boolean parameter indicating whether to retrieve soft deleted recordings or not. Recordings metadata are kept after deletion for a retention period of 40 days.

Response

OK

account_sidstring nullable

The SID of the Account that created the Recording resource.

api_versionstring nullable

The API version used during the recording.

call_sidstring nullable

The SID of the Call the Recording resource is associated with. This will always refer to the parent leg of a two-leg call.

conference_sidstring nullable

The Conference SID that identifies the conference associated with the recording, if a conference recording.

date_createdstring date-time-rfc-2822 nullable

The date and time in GMT that the resource was created specified in RFC 2822 format.

date_updatedstring date-time-rfc-2822 nullable

The date and time in GMT that the resource was last updated specified in RFC 2822 format.

start_timestring date-time-rfc-2822 nullable

The start time of the recording in GMT and in RFC 2822 format.

durationstring nullable

The length of the recording in seconds.

sidstring nullable

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

pricestring nullable

The one-time cost of creating the recording in the price_unit currency.

price_unitstring nullable

The currency used in the price property. Example: USD.

status'in-progress' | 'paused' | 'stopped' | 'processing' | 'completed' | 'absent' | 'deleted'

The status of the recording. Can be: processing, completed, absent or deleted. For information about more detailed statuses on in-progress recordings, check out how to Update a Recording Resource.

channelsinteger nullable

The number of channels in the recording resource. For information on specifying the number of channels in the downloaded recording file, check out Fetch a Recording’s media file.

source'DialVerb' | 'Conference' | 'OutboundAPI' | 'Trunking' | 'RecordVerb' | 'StartCallRecordingAPI' | 'StartConferenceRecordingAPI'

How the recording was created. Can be: DialVerb, Conference, OutboundAPI, Trunking, RecordVerb, StartCallRecordingAPI, and StartConferenceRecordingAPI.

error_codeinteger nullable

The error code that describes why the recording is absent. The error code is described in our Error Dictionary. This value is null if the recording status is not absent.

uristring nullable

The URI of the resource, relative to https://api.twilio.com.

encryption_detailsunknown
subresource_urisobject nullable

A list of related resources identified by their relative URIs.

media_urlstring uri nullable

The URL of the media file associated with this recording resource. When stored externally, this is the full URL location of the media file.

Changes

  • v2010475b69553e34Revision changes
    • breaking

      the response's property type changed from object to no type for status

  • v201082fa0c213f54Revision changes
    • breaking

      the response property became nullable for the status

    • info

      the response's property default value 0 was removed for the status