Skip to main content

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"
}
}
AttributeDescription
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 stringFurther 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.