---
title: "Fetch an instance of a recording"
method: GET
path: "/2010-04-01/Accounts/{AccountSid}/Recordings/{Sid}.json"
tags: ["Api20100401Recording"]
---

# 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

Fetch an instance of a recording

## Path parameters

- `AccountSid` string, required
- `Sid` string, required

## Query parameters

- `IncludeSoftDeleted` boolean

## Response `200`

OK

- ApiV2010AccountRecording
  - `account_sid` string, nullable: The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Recording resource.
  - `api_version` string, nullable: The API version used during the recording.
  - `call_sid` string, nullable: 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_sid` string, nullable: The Conference SID that identifies the conference associated with the recording, if a conference recording.
  - `date_created` string, date-time-rfc-2822, nullable: The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
  - `date_updated` string, date-time-rfc-2822, nullable: 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_time` string, date-time-rfc-2822, nullable: 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.
  - `duration` string, nullable: The length of the recording in seconds.
  - `sid` string, nullable: The unique string that that we created to identify the Recording resource.
  - `price` string, nullable: The one-time cost of creating the recording in the `price_unit` currency.
  - `price_unit` string, 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](https://www.twilio.com/docs/voice/api/recording#update-a-recording-resource).
  - `channels` integer, 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](https://www.twilio.com/docs/voice/api/recording#download-dual-channel-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_code` integer, nullable: 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`.
  - `uri` string, nullable: The URI of the resource, relative to `https://api.twilio.com`.
  - `encryption_details` unknown
  - `subresource_uris` object, nullable: A list of related resources identified by their relative URIs.
  - `media_url` string, 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

- **2025-07-03** (v2010) `475b69553e34`: 1 breaking
  - the `encryption_details` response's property type changed from `object` to no type for status `200`
- **2025-06-12** (v2010) `82fa0c213f54`: 1 breaking, 1 info
  - the response property `channels` became nullable for the status `200`
  - the `channels` response's property default value `0` was removed for the status `200`
- **2025-03-11** (v2010) `26011eceee1e`: 1 breaking
  - the `encryption_details` response's property type changed from no type to `object` for status `200`
- **2024-08-26** (v2010) `47a91f5ec38f`: 1 info
  - the `channels` response's property default value `0` was added for the status `200`

[Operation history](https://skmtc.dev/twilio/apis/api-v2010/changes/2010-04-01/Accounts/:AccountSid/Recordings/:Sid.json/get.md)

---

[API](https://skmtc.dev/twilio/apis/api-v2010.md) - [All operations](https://skmtc.dev/twilio/apis/api-v2010/llms.txt) - [OpenAPI document](https://skmtc.dev/twilio/apis/api-v2010/revisions/bfdf249a1298?raw)
