GET
/2010-04-01/Accounts/{AccountSid}/Recordings/{Sid}.jsonGet a recording
Retrieves a recording by its SID. Set IncludeSoftDeleted to include metadata for recordings that have been deleted; that metadata is retained for 40 days.
AccountSidstringrequired
The account SID associated with the recording, in the format `AC` followed by 32 hexadecimal characters.
Sidstringrequired
The recording SID, in the format `RE` followed by 32 hexadecimal characters.
IncludeSoftDeletedbooleanoptional
Whether to include metadata for soft-deleted recordings. Deleted recording metadata is retained for 40 days.
200Returns the recording object, including its account, call or conference association, SID, dates, duration, price, status, channels, source, and any error code.
account_sidstringoptional
The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Recording resource.
api_versionstringoptional
The API version used during the recording.
call_sidstringoptional
The SID of the [Call](https://www.twilio.com/docs/voice/api/call-resource) the Recording resource is associated with. This will always refer to the parent leg of a two-leg call.
conference_sidstringoptional
The Conference SID that identifies the conference associated with the recording, if a conference recording.
date_createdstringoptional
The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
date_updatedstringoptional
The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
start_timestringoptional
The start time of the recording in GMT and in [RFC 2822](https://www.php.net/manual/en/class.datetime.php#datetime.constants.rfc2822) format.
durationstringoptional
The length of the recording in seconds.
sidstringoptional
The unique string that that we created to identify the Recording resource.
pricestringoptional
The one-time cost of creating the recording in the `price_unit` currency.
price_unitstringoptional
The currency used in the `price` property. Example: `USD`.
statusstringoptional
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](https://www.twilio.com/docs/voice/api/recording#update-a-recording-resource).
channelsintegeroptional
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](https://www.twilio.com/docs/voice/api/recording#download-dual-channel-media-file).
sourcestringoptional
How the recording was created. Can be: `DialVerb`, `Conference`, `OutboundAPI`, `Trunking`, `RecordVerb`, `StartCallRecordingAPI`, and `StartConferenceRecordingAPI`.
error_codeintegeroptional
The error code that describes why the recording is `absent`. The error code is described in our [Error Dictionary](https://www.twilio.com/docs/api/errors). This value is null if the recording `status` is not `absent`.
uristringoptional
The URI of the resource, relative to `https://api.twilio.com`.
encryption_detailsunknownoptional
How to decrypt the recording if it was encrypted using [Call Recording Encryption](https://www.twilio.com/docs/voice/tutorials/voice-recording-encryption) feature.
subresource_urisobjectoptional
A list of related resources identified by their relative URIs.
media_urlstringoptional
The URL of the media file associated with this recording resource. When stored externally, this is the full URL location of the media file.
Error handling
The AccountSid path parameter must be a 34-character account SID beginning with AC followed by 32 hexadecimal characters, and the Sid path parameter must be a 34-character recording SID beginning with RE followed by 32 hexadecimal characters. Set IncludeSoftDeleted to true to retrieve soft-deleted recording metadata, which is retained for 40 days.