Recordings

A Recording represents a recording of a voice or conference call. It allows you to see meta information about the recording as well as access the media file itself.

Recordings remain stored indefinitely, until deleted with the appropriate API call.

Properties

Attribute	Type
account_sid	string	The unique identifier for the account that is associated with this recording.
api_version	string	The version of the SignalWire API.
call_sid	string	The unique identifier for the call that is associated with this recording.
channels	integer	The number of channels in a recording. Possible values are 1 or 2.
conference_sid	string	The unique identifier for the conference that is associated with this recording.
date_created	datetime	The date, in RFC 2822 format, this recording was created.
date_updated	datetime	The date, in RFC 2822 format, this recording was updated.
duration	string	The length, in seconds, of the recording.
error_code	-	Further details about a failed recording.
price	integer	The cost for the recording.
price_unit	string	The currency of the price of the recording.
sid	string	The unique identifier for the recording.
source	string	How the recording was made. Possible values are DialVerb, Conference, OutboundAPI, Trunking, RecordVerb, StartCallRecordingAPI, or StartConferenceRecording.
start_time	datetime	The time, in RFC 2822 format, this recording began.
status	string	The status of the recording.
uri	string	The URI of the recording.

A sample Recording object returned from the API:

{
  "account_sid": "720796a0-8ee9-4350-83bd-2d07a3121f1e",
  "api_version": "2010-04-01",
  "call_sid": "43bb71ee-553f-4074-bb20-8e2747647cce",
  "conference_sid": "2071320d-ee82-4578-84e0-379fb227eb77",
  "channels": 1,
  "date_created": "Tue, 25 Sept 2018 23:00:00 +0000",
  "date_updated": "Wed, 26 Sept 2018 23:00:04 +0000",
  "start_time": "Tue, 25 Sept 2018 23:00:00 +0000",
  "end_time": "Wed, 26 Sept 2018 23:00:04 +0000",
  "price": "-0.0025",
  "price_unit": "USD",
  "duration": "4",
  "sid": "19e436af-5688-4307-b03b-bdb2b42b8142",
  "source": "DialVerb",
  "status": "completed",
  "error_code": null,
  "uri": "/api/laml/2010-04-01/Accounts/720796a0-8ee9-4350-83bd-2d07a3121f1e/Calls/058a869c-d387-4bef-8e62-6b0bc0895bed/Recordings/19e436af-5688-4307-b03b-bdb2b42b8142.json",
  "subresource_uris": {
    "transcriptions": "/api/laml/2010-04-01/Accounts/720796a0-8ee9-4350-83bd-2d07a3121f1e/Recordings/19e436af-5688-4307-b03b-bdb2b42b8142/Transcriptions.json"
  }
}