Retrieve a Call
GET/Accounts/:AccountSid/Calls/:Sid
Retrieve a call.
Permissions
The API token must include the following scopes: Voice.
Request
Path Parameters
The Project ID that uniquely identifies the Account to retrieve.
The Call Sid that uniquely identifies the call to retrieve.
Responses
- 200
OK
- application/json
- Schema
- Example (from schema)
Schema
The unique identifier for the account that created this call.
The annotation for the call.
Possible values: [human
, machine
]
Who/what the call was answered by. Possible values are human
or machine
.
The version of the SignalWire API.
The name of the caller. Only available if Caller ID lookup is enabled.
The date, in RFC 2822 GMT format, this call was created.
The date, in RFC 2822 GMT format, this call was updated.
Possible values: [inbound
, outbound
]
The direction of the call. Possible values are inbound
or outbound
.
The duration, in seconds, of the call.
The time, in RFC 2822 GMT format, on which the call was terminated.
The number this call was forwarded from.
The address that initiated the call. Can be either a E.164 formatted number (+xxxxxxxxxxx
), or a SIP endpoint (sip:xxx@yyy.zzz
).
The formatted number that initiated the call.
The unique identifier for the call that created this call.
Outbound call: the unique identifier for OutgoingCallerId
. Inbound call: the unique identifier for IncomingPhoneNumber
.
The charge for the call.
The currency, in ISO 4127 format, for the price of the call.
The unique identifier for the call.
The time, in RFC 2822 GMT format, on which the call began.
Possible values: [queued
, ringing
, in-progress
, canceled
, completed
, busy
, failed
]
The status of the call.
subresource_uris
object
A Map of available sub-resources.
The URI for notifications
The URI for recordings
The address that received the call. Can be either a E.164 formatted number (+xxxxxxxxxxx
), or a SIP endpoint (sip:xxx@yyy.zzz
).
The formatted number that received the call.
The URI for the call.
{
"account_sid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"annotation": "string",
"answered_by": "machine",
"api_version": "2010-04-01T00:00:00.000Z",
"caller_name": null,
"date_created": "Wed, 19 Sept 2018 20:00:00 +0000",
"date_updated": "Wed, 19 Sept 2018 21:00:00 +0000",
"direction": "inbound",
"duration": 20,
"end_time": "Fri, 21 Sept 2018 10:00:00 +0000",
"forwarded_from": "+13102259067",
"from": "+13103384645",
"formatted_from": "+13102259067",
"parent_call_sid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"phone_number_sid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"price": 0.003,
"price_unit": "USD",
"sid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"start_time": "Wed, 19 Sept 2018 20:00:01 +0000",
"status": "queued",
"subresource_uris": {
"notifications": "/api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Calls/b3877c40-da60-4998-90ad-b792e98472pa/Notifications.json",
"recordings": "/api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Calls/b3877c40-da60-4998-90ad-b792e98472pa/Recordings.json"
},
"to": "+13105678901",
"formatted_to": "(310) 567-8901",
"uri": "/api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Calls/b3877c40-da60-4998-90ad-b792e98472pa.json"
}