Path parameters

• AccountSid string Required

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

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

• Sid string Required

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

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

Query parameters

• IncludeSoftDeleted boolean

  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.

Responses

• 200 application/json

  OK

  Hide headers attributes Show headers attributes

  • Access-Control-Allow-Origin string

    Specify the origin(s) allowed to access the resource

  • Access-Control-Allow-Methods string

    Specify the HTTP methods allowed when accessing the resource

  • Access-Control-Allow-Headers string

    Specify the headers allowed when accessing the resource

  • Access-Control-Allow-Credentials boolean

    Indicates whether the browser should include credentials

  • Access-Control-Expose-Headers string

    Headers exposed to the client

  Hide response attributes Show response attributes object

  • account_sid string | null

    The SID of the Account that created the Recording resource.

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

  • api_version string | null

    The API version used during the recording.

  • call_sid string | null

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

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

  • conference_sid string | null

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

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

  • date_created string(date-time-rfc-2822) | null

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

  • date_updated string(date-time-rfc-2822) | null

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

  • start_time string(date-time-rfc-2822) | null

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

  • duration string | null

    The length of the recording in seconds.

  • sid string | null

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

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

  • price string | null

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

  • price_unit string | null

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

  • status string

    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.

    Values are in-progress, paused, stopped, processing, completed, absent, or deleted.

  • channels integer | null

    The number of channels in the final recording file. Can be: 1 or 2. Default: 1.

  • source string

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

    Values are DialVerb, Conference, OutboundAPI, Trunking, RecordVerb, StartCallRecordingAPI, or StartConferenceRecordingAPI.

  • error_code integer | null

    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.

  • uri string | null

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

  • encryption_details

    How to decrypt the recording if it was encrypted using Call Recording Encryption feature.

  • subresource_uris object(uri-map) | null

    A list of related resources identified by their relative URIs.

  • media_url string(uri) | null

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