List all Calls

GET 
/Accounts/:AccountSid/Calls

List all calls.

Permissions

The API token must include the following scopes: Voice.

Request

Path Parameters

AccountSid uuidrequired

The Project ID that uniquely identifies the Account to retrieve.

Query Parameters

EndTime string
EndTime< string
EndTime> string
From string
ParentCallSid uuid
StartTime string
StartTime< string
StartTime> string
Status string

Possible values: [queued, ringing, in-progress, canceled, completed, busy, failed]

To string

Responses

200

OK

application/json

Schema

Schema

uristring
first_page_uristring
next_page_uristring
previous_page_uristring
pageinteger
page_sizeinteger
account_siduuid

The unique identifier for the account that created this call.

calls

object[]

Array [

account_siduuid

The unique identifier for the account that created this call.

annotationstring

The annotation for the call.

answered_bystring

Who/what the call was answered by. Possible values are human or machine.

Possible values: [human, machine]

Example: machine

api_version

The version of the SignalWire API.

Example: 2010-04-01T00:00:00.000Z

date_createdstring

The date, in RFC 2822 GMT format, this call was created.

Example: Wed, 19 Sept 2018 20:00:00 +0000

date_updatedstring

The date, in RFC 2822 GMT format, this call was updated.

Example: Wed, 19 Sept 2018 21:00:00 +0000

directionstring

The direction of the call. Possible values are inbound or outbound.

Possible values: [inbound, outbound]

Example: inbound

durationnumber

The duration, in seconds, of the call.

Example: 20

end_timestring

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

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

forwarded_fromstring

The number this call was forwarded from.

Example: +13102259067

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

formatted_fromstring

The formatted number that initiated the call.

Example: +13102259067

parent_call_siduuid

The unique identifier for the call that created this call.

phone_number_siduuid

Outbound call: the unique identifier for OutgoingCallerId. Inbound call: the unique identifier for IncomingPhoneNumber.

pricenumber

The charge for the call.

Example: 0.003

price_unitstring

The currency, in ISO 4127 format, for the price of the call.

Example: USD

siduuid

The unique identifier for the call.

start_timestring

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

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

statusstring

The status of the call.

Possible values: [queued, ringing, in-progress, canceled, completed, busy, failed]

Example: queued

subresource_uris

object

A Map of available sub-resources.

notificationsstring

The URI for notifications

Example: /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Calls/b3877c40-da60-4998-90ad-b792e98472pa/Notifications.json

recordingsstring

The URI for recordings

Example: /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Calls/b3877c40-da60-4998-90ad-b792e98472pa/Recordings.json

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

formatted_tostring

The formatted number that received the call.

Example: (310) 567-8901

uristring

The URI for the call.

Example: /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Calls/b3877c40-da60-4998-90ad-b792e98472pa.json

]

Example (from schema)

{
  "uri": "string",
  "first_page_uri": "string",
  "next_page_uri": "string",
  "previous_page_uri": "string",
  "page": 0,
  "page_size": 0,
  "account_sid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "calls": [
    {
      "account_sid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "annotation": "string",
      "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",
      "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"
    }
  ]
}