Listing Calls

A Call represents a connection between a phone or user agent and the platform. This may be inbound or outbound. The Calls list resource represents the set of phone calls originated and terminated from an account. This section will focus on only using HTTP GET functions.

Section URI

/call/2012-04-24/Accounts/{AccountSid}/Calls
or
/call/2012-04-24/Accounts/{AccountSid}/Calls/{CallSid}

Calls Attributes

Attribute
Description
Sid
A string that uniquely identifies a call.
ParentCallSid
A string that uniquely identifies the call that created this leg.
DateCreated
The date that this call was created.
DateUpdated
The date that this call was last updated.
AccountSid
The unique id of the Account that created this call.
To
The phone number or identifier that will be the recipient of this call.
From
The phone number or identifier that originated this call.
PhoneNumberSid
If the call was inbound, this is the Sid of the IncomingPhoneNumber that received the call.
Status
A string representing the status of the call. Possible values are queued, ringing, in-progress, completed, failed, busy and no-answer.
StartTime
The start time of the call. Empty if the call has not yet been started.
EndTime
The end time of the call. Empty if the call has not ended.
Duration
The length of the call in seconds.
Price
The charge for this call, in the currency associated with the account. Populated after the call is completed.
Direction
A string describing the direction of the call. Possible values are inbound, outbound-api, and outbound-dial
AnsweredBy
If this call was initiated with answering machine detection, either human or machine. Empty otherwise.
ApiVersion
Displays the current API version
ForwardFrom
If this call was an incoming call forwarded from another number, the forwarding phone number (depends on carrier supporting forwarding). Empty otherwise.
CallerName
If this call was an incoming call, the caller’s name. Empty otherwise.
Uri
The URI for this account, relative to https://api.teleapi.net/call/2012-04-24/.

Get call details

HTTP GET Returns the representation of a Call resource, including the properties above.