Sample - Twilio API
GET/2010-04-01/Accounts/{AccountSid}/Recordings/{Sid}.json

Retrieve a recording

Retrieves a recording from an account. Supply IncludeSoftDeleted when you need to include recording metadata that was soft deleted during its 40-day retention period. The response includes recording status, source, timing, duration, pricing, and associated call or conference identifiers.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

3 parameters
AccountSidstringrequired
The account SID that created the recording. Must be a 34-character value matching `^AC[0-9a-fA-F]{32}$`.
Sidstringrequired
The unique recording SID to retrieve. Must be a 34-character value matching `^RE[0-9a-fA-F]{32}$`.
IncludeSoftDeletedbooleanoptional
Whether to include soft-deleted recording metadata. Soft-deleted metadata is retained for 40 days.

1 status code
200Returns the recording object with its account and call or conference associations, timestamps, start time, duration, price, currency, status, channel count, source, and any applicable 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).
Allowed:in-progresspausedstoppedprocessingcompletedabsentdeleted
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`.
Allowed:DialVerbConferenceOutboundAPITrunkingRecordVerbStartCallRecordingAPIStartConferenceRecordingAPI
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

AccountSid must be a 34-character account SID matching the AC prefix format, and Sid must be a 34-character recording SID matching the RE prefix format. Set IncludeSoftDeleted to true only when you need metadata for recordings that were soft deleted and remain within the 40-day retention period.