Calls

List all Calls

List all calls.

Permissions

The API token must include the following scopes: Voice.

get/Accounts/{AccountSid}/Calls

Path parameters

AccountSidstring uuid required

The Project ID that uniquely identifies the Account.

Query parameters

EndTimestring

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

EndTime<string

The time before which the call was terminated.

EndTime>string

The time after which the call was terminated.

Fromstring

The address that initiated the call.

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.

StartTime<string

The time before which the call began.

StartTime>string

The time after which the call began.

Status'queued' | 'ringing' | 'in-progress' | 'canceled' | 'completed' | 'busy' | 'failed'

The status of the call.

Tostring

The address that received the call.

Response

The request has succeeded.

uristring

The URI of the current page.

first_page_uristring

The URI of the first page.

next_page_uristring

The URI of the next page.

previous_page_uristring

The URI of the previous page.

pageinteger

The current page number.

page_sizeinteger

The number of items per page.

account_sidstring uuid

The unique identifier for the account.

Example response

{
  "uri": "/api/laml/2010-04-01/Accounts?Page=0&PageSize=50",
  "first_page_uri": "/api/laml/2010-04-01/Accounts?Page=0&PageSize=50",
  "next_page_uri": "/api/laml/2010-04-01/Accounts?Page=1&PageSize=50",
  "page_size": 50,
  "calls": [
    {
      "account_sid": "b3877c40-da60-4998-90ad-b792e98472af",
      "annotation": "Call annotation text",
      "api_version": "2010-04-01",
      "date_created": "Wed, 19 Sept 2018 20:00:00 +0000",
      "date_updated": "Wed, 19 Sept 2018 21:00:00 +0000",
      "duration": 20,
      "end_time": "Fri, 21 Sept 2018 10:00:00 +0000",
      "forwarded_from": "+13102259067",
      "from": "+13103384645",
      "formatted_from": "+13102259067",
      "parent_call_sid": "b3877c40-da60-4998-90ad-b792e98472af",
      "phone_number_sid": "b3877c40-da60-4998-90ad-b792e98472pn",
      "price": 0.003,
      "price_unit": "USD",
      "sid": "b3877c40-da60-4998-90ad-b792e98472ca",
      "start_time": "Wed, 19 Sept 2018 20:00:01 +0000",
      "subresource_uris": {
        "notifications": "/api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Calls/b3877c40-da60-4998-90ad-b792e98472ca/Notifications.json",
        "recordings": "/api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Calls/b3877c40-da60-4998-90ad-b792e98472ca/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-b792e98472ca.json"
    }
  ]
}

Changes