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,
by setting the record
attribute for Calls,
or by using Conferences.
Properties
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"
}
}
Attribute | Description |
---|---|
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 string | 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. |