Sign in

v36

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-1279125449.6 KB
Calls

List all Calls

List all calls.

Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: Voice.

Learn more about API scopes.

get/Accounts/{AccountSid}/Calls

Path parameters

AccountSidstring uuid required

Universal Unique Identifier.

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

Universal Unique Identifier.

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' | 'no-answer'

The status of the call.

Tostring

The address that received the call.

Pageinteger

The page number to retrieve. Page numbers are zero-indexed, so the first page is 0.

PageSizeinteger

The number of results to return per page. The default is 50, and the maximum is 1000.

PageTokenstring

A token used to retrieve a specific page of results. Must start with PA or PB.

Response

The request has succeeded.

uristring required

The URI of the current page.

first_page_uristring required

The URI of the first page.

next_page_uristring nullable required

The URI of the next page.

previous_page_uristring nullable required

The URI of the previous page.

pageinteger required

The current page number.

page_sizeinteger required

The number of items per page.

Example response

{
  "uri": "/api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Calls?Page=0&PageSize=50",
  "first_page_uri": "/api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Calls?Page=0&PageSize=50",
  "next_page_uri": "/api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Calls?Page=1&PageSize=50&PageToken=PAxxxxxxxxxx",
  "page_size": 50,
  "calls": [
    {
      "date_created": "Wed, 19 Sep 2018 20:00:00 +0000",
      "date_updated": "Wed, 19 Sep 2018 21:00:00 +0000",
      "to": "+13105678901",
      "formatted_to": "(310) 567-8901",
      "to_formatted": "(310) 567-8901",
      "from": "+13103384645",
      "formatted_from": "(310) 338-4645",
      "from_formatted": "(310) 338-4645",
      "start_time": "Wed, 19 Sep 2018 20:00:01 +0000",
      "end_time": "Fri, 21 Sep 2018 10:00:00 +0000",
      "duration": 20,
      "price": 0.003,
      "price_unit": "USD",
      "api_version": "2010-04-01",
      "uri": "/api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Calls/b3877c40-da60-4998-90ad-b792e98472ca.json",
      "subresource_uris": {
        "recordings": "/api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Calls/b3877c40-da60-4998-90ad-b792e98472ca/Recordings.json"
      },
      "audio_in_mos": 4.5,
      "sip_result_code": "200",
      "audio_rtt_avg": 50,
      "audio_rtt_min": 20,
      "audio_rtt_max": 100,
      "audio_out_jitter_min": 1,
      "audio_out_jitter_max": 10,
      "audio_out_jitter_avg": 5
    }
  ]
}