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 can be initiated using the <Record> verb or by setting the record attribute for Calls or Conferences.

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

Properties

Attribute
account_sid stringThe unique identifier for the account that is associated with this recording.
api_version stringThe version of the SignalWire API.
call_sid stringThe unique identifier for the call that is associated with this recording.
channels integerThe number of channels in a recording. Possible values are 1 or 2.
conference_sid stringThe unique identifier for the conference that is associated with this recording.
date_created datetimeThe date, in RFC 2822 format, this recording was created.
date_updated datetimeThe date, in RFC 2822 format, this recording was updated.
duration stringThe length, in seconds, of the recording.
error_code <string/span>Further details about a failed recording.
price integerThe cost for the recording.
price_unit stringThe currency of the price of the recording.
sid stringThe unique identifier for the recording.
source stringHow the recording was made. Possible values are DialVerb, Conference, OutboundAPI, Trunking, RecordVerb, StartCallRecordingAPI, or StartConferenceRecording.
start_time datetimeThe time, in RFC 2822 format, this recording began.
status stringThe status of the recording.
uri stringThe 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"
  }
}