Calls

List all Calls

List all calls.

Permissions

The API token must include the following scopes: Voice.

get/Accounts/{AccountSid}/Calls

Query parameters

EndTimestring

The time, in RFC 2822 GMT format, on which the call was terminated.

Example:Fri, 21 Sept 2018 10:00:00 +0000
EndTime<string

The time, in RFC 2822 GMT format, before which the call was terminated.

Example:Fri, 21 Sept 2018 10:00:00 +0000
EndTime>string

The time, in RFC 2822 GMT format, after which the call was terminated.

Example:Fri, 21 Sept 2018 10:00:00 +0000
Fromstring

The address that initiated the call. Can be either a E.164 formatted number (+xxxxxxxxxxx), or a SIP endpoint (sip:xxx@yyy.zzz).

Example:+13103384645
ParentCallSidstring uuid

The unique identifier for the call that created this call.

StartTimestring

The time, in RFC 2822 GMT format, on which the call began.

Example:Wed, 19 Sept 2018 20:00:01 +0000
StartTime<string

The time, in RFC 2822 GMT format, before which the call began.

Example:Wed, 19 Sept 2018 20:00:01 +0000
StartTime>string

The time, in RFC 2822 GMT format, after which the call began.

Example:Wed, 19 Sept 2018 20:00:01 +0000
Status'queued' | 'ringing' | 'in-progress' | 'canceled' | 'completed' | 'busy' | 'failed'

The status of the call.

Example:queued
Tostring

The address that received the call. Can be either a E.164 formatted number (+xxxxxxxxxxx), or a SIP endpoint (sip:xxx@yyy.zzz).

Example:+13105678901

Response

OK

uristring
first_page_uristring
next_page_uristring
previous_page_uristring
pageinteger
page_sizeinteger
account_sidstring uuid

The unique identifier for the account that created this call.

Example response

{
  "calls": [
    {
      "answered_by": "machine",
      "api_version": "2010-04-01T00:00:00.000Z",
      "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",
      "price": 0.003,
      "price_unit": "USD",
      "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"
    }
  ]
}

Changes