Call Summaries Resource

A Call Summary provides an overview of

metadata, and
quality metrics

for a single call.

Using the Call Summaries Resource, you can get a list of Call Summaries.

To get the Call Summary for an individual call use the Call Summary Resource.

(information)

Info

Voice Insights Advanced Features must be active to use this API Resource.

(information)

Info

A completed Call Summary may take up to a half hour to generate, but a partial summary record will be available within ten minutes of a call ending.

Call Summary properties

The following table contains the top-level properties of a single Call Summary instance.

A Call Summary is a complex data structure with several of the top-level properties constituting nested objects.

The top level contains attributes and properties objects, and each edge of a call has metrics for both directions of the media stream as well as properties and summarized metrics. Further information for these object-typed properties can be found on the Details: Call Summary page.

Whether a particular edge is present will depend on the call type. A Voice SDK call will have an sdk_edge and a client_edge. A SIP trunking call will have a sip_edge and a carrier_edge. A SIP domain or <Dial><Sip> call will have only a sip_edge. A PSTN call will have only a carrier_edge. See Understanding Twilio Media Edges for a conceptual explanation.

Resource properties

account_sidtype: SID<AC>Not PII

The unique SID identifier of the Account.

call_sidtype: SID<CA>Not PII

The unique SID identifier of the Call.

answered_bytype: enum<STRING>Not PII

The Answered By value for the summarized call based on Answering Machine Detection (AMD). One of unknown, machine_start, machine_end_beep, machine_end_silence, machine_end_other, human or fax. Refer to AMD for more detail.

Possible values:

unknownmachine_startmachine_end_beepmachine_end_silencemachine_end_otherhumanfax

call_typetype: enum<STRING>Not PII

The Call Type of the summarized Call. One of carrier, sip, trunking or client.

Possible values:

carriersiptrunkingclient

call_statetype: enum<STRING>Not PII

The Call State of the summarized Call. One of ringing, completed, busy, fail, noanswer, canceled, answered, undialed.

Possible values:

ringingcompletedbusyfailnoanswercanceledansweredundialed

processing_statetype: enum<STRING>Not PII

The Processing State of the Call Summary. The Processing State will be partial until the assembly of the Call Summary finishes, which occurs approximately 30 minutes after Call end. Then the Processing State changes to complete

Possible values:

completepartial

created_timetype: string<DATE TIME>Not PII

The time at which the Call was created, given in ISO 8601 format. Can be different from start_time in the event of queueing due to CPS

start_timetype: string<DATE TIME>Not PII

The time at which the Call was started, given in ISO 8601 format.

end_timetype: string<DATE TIME>Not PII

The time at which the Call was ended, given in ISO 8601 format.

durationtype: integerNot PII

Duration between when the call was initiated and the call was ended

connect_durationtype: integerNot PII

Duration between when the call was answered and when it ended

fromtype: objectPII MTL: 30 days

The calling party.

totype: objectPII MTL: 30 days

The called party.

carrier_edgetype: objectNot PII

Contains metrics and properties for the Twilio media gateway of a PSTN call.

client_edgetype: objectNot PII

Contains metrics and properties for the Twilio media gateway of a Client call.

sdk_edgetype: objectNot PII

Contains metrics and properties for the SDK sensor library for Client calls.

sip_edgetype: objectNot PII

Contains metrics and properties for the Twilio media gateway of a SIP Interface or Trunking call.

tagstype: string[]Not PII

Tags applied to calls by Voice Insights analysis indicating a condition that could result in subjective degradation of the call quality.

urltype: string<URI>Not PII

The URL of this resource.

attributestype: objectNot PII

Attributes capturing call-flow-specific details.

propertiestype: objectNot PII

Contains edge-agnostic call-level details.

trusttype: objectNot PII

Contains trusted communications details including Branded Call and verified caller ID.

annotationtype: objectNot PII

Read multiple Call Summary resources

GET https://insights.twilio.com/v1/Voice/Summaries

Parameters

URI parameters

Fromtype: stringPII MTL: 30 days

Query Parameter

A calling party. Could be an E.164 number, a SIP URI, or a Twilio Client registered name.

Totype: stringPII MTL: 30 days

Query Parameter

A called party. Could be an E.164 number, a SIP URI, or a Twilio Client registered name.

FromCarriertype: stringNot PII

Query Parameter

An origination carrier.

ToCarriertype: stringNot PII

Query Parameter

A destination carrier.

FromCountryCodetype: stringNot PII

Query Parameter

A source country code based on phone number in From.

ToCountryCodetype: stringNot PII

Query Parameter

A destination country code. Based on phone number in To.

Brandedtype: booleanNot PII

Query Parameter

A boolean flag indicating whether or not the calls were branded using Twilio Branded Calls.

VerifiedCallertype: booleanNot PII

Query Parameter

A boolean flag indicating whether or not the caller was verified using SHAKEN/STIR.

HasTagtype: booleanNot PII

Query Parameter

A boolean flag indicating the presence of one or more Voice Insights Call Tags.

StartTimetype: stringNot PII

Query Parameter

A Start time of the calls. xm (x minutes), xh (x hours), xd (x days), 1w, 30m, 3d, 4w or datetime-ISO. Defaults to 4h.

EndTimetype: stringNot PII

Query Parameter

An End Time of the calls. xm (x minutes), xh (x hours), xd (x days), 1w, 30m, 3d, 4w or datetime-ISO. Defaults to 0m.

CallTypetype: stringNot PII

Query Parameter

A Call Type of the calls. One of carrier, sip, trunking or client.

CallStatetype: stringNot PII

Query Parameter

A Call State of the calls. One of ringing, completed, busy, fail, noanswer, canceled, answered, undialed.

Directiontype: stringNot PII

Query Parameter

A Direction of the calls. One of outbound_api, outbound_dial, inbound, trunking_originating, trunking_terminating.

ProcessingStatetype: enum<STRING>Not PII

Query Parameter

A Processing State of the Call Summaries. One of completed, partial or all.

Possible values:

completedstartedpartialall

SortBytype: enum<STRING>Not PII

Query Parameter

A Sort By criterion for the returned list of Call Summaries. One of start_time or end_time.

Possible values:

start_timeend_time

Subaccounttype: SID<AC>Not PII

Query Parameter

A unique SID identifier of a Subaccount.

AbnormalSessiontype: booleanNot PII

Query Parameter

A boolean flag indicating an abnormal session where the last SIP response was not 200 OK.

AnsweredBytype: enum<STRING>Not PII

Query Parameter

An Answered By value for the calls based on Answering Machine Detection (AMD). One of unknown, machine_start, machine_end_beep, machine_end_silence, machine_end_other, human or fax.

Possible values:

unknownmachine_startmachine_end_beepmachine_end_silencemachine_end_otherhumanfax

AnsweredByAnnotationtype: stringNot PII

Query Parameter

Either machine or human.

ConnectivityIssueAnnotationtype: stringNot PII

Query Parameter

A Connectivity Issue with the calls. One of no_connectivity_issue, invalid_number, caller_id, dropped_call, or number_reachability.

QualityIssueAnnotationtype: stringNot PII

Query Parameter

A subjective Quality Issue with the calls. One of no_quality_issue, low_volume, choppy_robotic, echo, dtmf, latency, owa, static_noise.

SpamAnnotationtype: booleanNot PII

Query Parameter

A boolean flag indicating spam calls.

CallScoreAnnotationtype: stringNot PII

Query Parameter

A Call Score of the calls. Use a range of 1-5 to indicate the call experience score, with the following mapping as a reference for the rated call [5: Excellent, 4: Good, 3 : Fair, 2 : Poor, 1: Bad].

PageSizetype: integerNot PII

Query Parameter

How many resources to return in each list page. The default is 50, and the maximum is 1000.

Pagetype: integerNot PII

Query Parameter

The page index. This value is simply for client state.

PageTokentype: stringNot PII

Query Parameter

The page token. This is provided by the API.

Read multiple Call Summaries

Node.js

Python

Java

PHP

Ruby

twilio-cli

curl


_10// Download the helper library from https://www.twilio.com/docs/node/install
_10// Find your Account SID and Auth Token at twilio.com/console
_10// and set the environment variables. See http://twil.io/secure
_10const accountSid = process.env.TWILIO_ACCOUNT_SID;
_10const authToken = process.env.TWILIO_AUTH_TOKEN;
_10const client = require('twilio')(accountSid, authToken);
_10
_10client.insights.v1.callSummaries
_10      .list({limit: 20})
_10      .then(callSummaries => callSummaries.forEach(c => console.log(c.to)));

Output


_12{
_12  "meta": {
_12    "page": 0,
_12    "page_size": 25,
_12    "first_page_url": "https://insights.twilio.com/v1/Voice/Summaries?PageSize=25&Page=0",
_12    "previous_page_url": "https://insights.twilio.com/v1/Voice/Summaries?PageSize=25&Page=0",
_12    "next_page_url": "https://insights.twilio.com/v1/Voice/Summaries?PageSize=25&Page=1",
_12    "key": "call_summaries",
_12    "url": "https://insights.twilio.com/v1/Voice/Summaries?PageSize=25&Page=0"
_12  },
_12  "call_summaries": []
_12}

Read multiple Call Summaries from to/from specific carriers for a data range

Node.js

Python

Java

PHP

Ruby

twilio-cli

curl


_10// Download the helper library from https://www.twilio.com/docs/node/install
_10// Find your Account SID and Auth Token at twilio.com/console
_10// and set the environment variables. See http://twil.io/secure
_10const accountSid = process.env.TWILIO_ACCOUNT_SID;
_10const authToken = process.env.TWILIO_AUTH_TOKEN;
_10const client = require('twilio')(accountSid, authToken);
_10
_10client.insights.v1.callSummaries
_10      .list({startTime: '4h', toCarrier: 'AT&T Wireless', limit: 20})
_10      .then(callSummaries => callSummaries.forEach(c => console.log(c.to)));

Output


_190{
_190  "meta": {
_190    "page": 0,
_190    "page_size": 25,
_190    "first_page_url": "https://insights.twilio.com/v1/Voice/Summaries?ToCarrier=AT%26T+Wireless&AnsweredBy=machine_start&StartTime=4h&PageSize=25&Page=0",
_190    "previous_page_url": "https://insights.twilio.com/v1/Voice/Summaries?ToCarrier=AT%26T+Wireless&AnsweredBy=machine_start&StartTime=4h&PageSize=25&Page=0",
_190    "next_page_url": "https://insights.twilio.com/v1/Voice/Summaries?ToCarrier=AT%26T+Wireless&AnsweredBy=machine_start&StartTime=4h&PageSize=25&Page=1",
_190    "key": "call_summaries",
_190    "url": "https://insights.twilio.com/v1/Voice/Summaries?ToCarrier=AT%26T+Wireless&AnsweredBy=machine_start&StartTime=4h&PageSize=25&Page=0"
_190  },
_190  "call_summaries": [
_190    {
_190      "call_sid": "CAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_190      "account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_190      "created_time": "2021-08-25T03:40:25Z",
_190      "start_time": "2021-08-25T03:40:25Z",
_190      "end_time": "2021-08-25T03:40:45Z",
_190      "duration": 20,
_190      "connect_duration": 20,
_190      "call_type": "carrier",
_190      "call_state": "completed",
_190      "answered_by": "machine_start",
_190      "from": {
_190        "caller": "+15555555555",
_190        "carrier": "T-Mobile USA, Inc.",
_190        "connection": "mobile",
_190        "number_prefix": "1555",
_190        "location": {
_190          "lat": 40.83885,
_190          "lon": -74.04568
_190        },
_190        "country_code": "US"
_190      },
_190      "to": {
_190        "callee": "+15555555556",
_190        "carrier": "AT&T Wireless",
_190        "connection": "mobile",
_190        "number_prefix": "1555",
_190        "location": {
_190          "lat": 33.42767,
_190          "lon": -86.886475
_190        },
_190        "country_code": "US"
_190      },
_190      "processing_state": "complete",
_190      "sdk_edge": null,
_190      "sip_edge": null,
_190      "client_edge": null,
_190      "carrier_edge": {
_190        "properties": {
_190          "media_region": "us1",
_190          "signaling_region": "us1",
_190          "edge_location": "xxxxx",
_190          "direction": "inbound"
_190        },
_190        "metrics": {
_190          "inbound": {
_190            "codec": 0,
_190            "codec_name": "pcmu",
_190            "packets_received": 202,
_190            "packets_lost": 0,
_190            "packets_loss_percentage": 0.0,
_190            "jitter": {
_190              "max": 1.48209,
_190              "avg": 0.483035
_190            }
_190          },
_190          "outbound": {
_190            "codec": 0,
_190            "codec_name": "pcmu",
_190            "packets_sent": 218,
_190            "packets_lost": 0,
_190            "packets_loss_percentage": 0.0,
_190            "jitter": {
_190              "max": 0.51868,
_190              "avg": 0.364434
_190            }
_190          }
_190        }
_190      },
_190      "tags": [
_190        "high_packet_loss",
_190        "high_jitter"
_190      ],
_190      "attributes": {
_190        "conference_participant": false
_190      },
_190      "properties": {
_190        "last_sip_response_num": 200,
_190        "pdd_ms": 121,
_190        "disconnected_by": "callee",
_190        "direction": "inbound"
_190      },
_190      "trust": {
_190        "verified_caller": {
_190          "verified": true
_190        }
_190      },
_190      "annotation": null,
_190      "url": "https://insights.twilio.com/v1/Voice/Summaries"
_190    },
_190    {
_190      "call_sid": "CAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_190      "account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_190      "created_time": "2021-08-25T02:20:25Z",
_190      "start_time": "2021-08-25T02:20:25Z",
_190      "end_time": "2021-08-25T02:40:45Z",
_190      "duration": 18,
_190      "connect_duration": 18,
_190      "call_type": "carrier",
_190      "call_state": "completed",
_190      "answered_by": "machine_start",
_190      "from": {
_190        "caller": "+15555555555",
_190        "carrier": "T-Mobile USA, Inc.",
_190        "connection": "mobile",
_190        "number_prefix": "1555",
_190        "location": {
_190          "lat": 40.83885,
_190          "lon": -74.04568
_190        },
_190        "country_code": "US"
_190      },
_190      "to": {
_190        "callee": "+15555555556",
_190        "carrier": "AT&T Wireless",
_190        "connection": "mobile",
_190        "number_prefix": "1555",
_190        "location": {
_190          "lat": 33.42767,
_190          "lon": -86.886475
_190        },
_190        "country_code": "US"
_190      },
_190      "processing_state": "complete",
_190      "sdk_edge": null,
_190      "sip_edge": null,
_190      "client_edge": null,
_190      "carrier_edge": {
_190        "properties": {
_190          "media_region": "us1",
_190          "signaling_region": "us1",
_190          "edge_location": "xxxxx",
_190          "direction": "inbound"
_190        },
_190        "metrics": {
_190          "inbound": {
_190            "codec": 0,
_190            "codec_name": "pcmu",
_190            "packets_received": 100,
_190            "packets_lost": 0,
_190            "packets_loss_percentage": 0.0,
_190            "jitter": {
_190              "max": 1.48209,
_190              "avg": 0.483035
_190            }
_190          },
_190          "outbound": {
_190            "codec": 0,
_190            "codec_name": "pcmu",
_190            "packets_sent": 102,
_190            "packets_lost": 0,
_190            "packets_loss_percentage": 0.0,
_190            "jitter": {
_190              "max": 0.51868,
_190              "avg": 0.364434
_190            }
_190          }
_190        }
_190      },
_190      "tags": null,
_190      "attributes": {
_190        "conference_participant": false
_190      },
_190      "properties": {
_190        "last_sip_response_num": 200,
_190        "pdd_ms": 121,
_190        "disconnected_by": "callee",
_190        "direction": "inbound"
_190      },
_190      "trust": {
_190        "verified_caller": {
_190          "verified": true
_190        }
_190      },
_190      "annotation": null,
_190      "url": "https://insights.twilio.com/v1/Voice/Summaries"
_190    }
_190  ]
_190}

Read multiple Call Summaries from a subaccount with detected issues

Node.js

Python

Java

PHP

Ruby

twilio-cli

curl


_16// Download the helper library from https://www.twilio.com/docs/node/install
_16// Find your Account SID and Auth Token at twilio.com/console
_16// and set the environment variables. See http://twil.io/secure
_16const accountSid = process.env.TWILIO_ACCOUNT_SID;
_16const authToken = process.env.TWILIO_AUTH_TOKEN;
_16const client = require('twilio')(accountSid, authToken);
_16
_16client.insights.v1.callSummaries
_16      .list({
_16         startTime: '7d',
_16         hasTag: true,
_16         subaccount: 'ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaab',
_16         callType: 'client',
_16         limit: 20
_16       })
_16      .then(callSummaries => callSummaries.forEach(c => console.log(c.to)));

Output


_164{
_164  "meta": {
_164    "page": 0,
_164    "page_size": 25,
_164    "first_page_url": "https://insights.twilio.com/v1/Voice/Summaries?CallType=client&StartTime=7d&HasTag=True&Subaccount=ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&PageSize=25&Page=0",
_164    "previous_page_url": "https://insights.twilio.com/v1/Voice/Summaries?CallType=client&StartTime=7d&HasTag=True&Subaccount=ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&PageSize=25&Page=0",
_164    "next_page_url": "https://insights.twilio.com/v1/Voice/Summaries?CallType=client&StartTime=7d&HasTag=True&Subaccount=ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&PageSize=25&Page=1",
_164    "key": "call_summaries",
_164    "url": "https://insights.twilio.com/v1/Voice/Summaries?CallType=client&StartTime=7d&HasTag=True&Subaccount=ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&PageSize=25&Page=0"
_164  },
_164  "call_summaries": [
_164    {
_164      "call_sid": "CAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_164      "account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_164      "created_time": "2021-08-25T04:16:35Z",
_164      "start_time": "2021-08-25T04:16:36Z",
_164      "end_time": "2021-08-25T04:16:42Z",
_164      "duration": 7,
_164      "connect_duration": 6,
_164      "call_type": "client",
_164      "call_state": "completed",
_164      "answered_by": "machine_start",
_164      "from": {
_164        "caller": "client:+15555555555",
_164        "connection": "twilio_sdk"
_164      },
_164      "to": {
_164        "callee": "client:TBBXXXXXXXXXXXX",
_164        "connection": "twilio_sdk"
_164      },
_164      "processing_state": "complete",
_164      "sdk_edge": null,
_164      "sip_edge": null,
_164      "client_edge": {
_164        "properties": {
_164          "media_region": "us1",
_164          "signaling_region": "us1",
_164          "twilio_media_ip": "54.xxx.xx.xxx",
_164          "external_media_ip": "54.xxx.xx.xxx",
_164          "edge_location": "xxxxxx",
_164          "direction": "inbound"
_164        },
_164        "metrics": {
_164          "inbound": {
_164            "codec": 0,
_164            "codec_name": "pcmu",
_164            "packets_received": 252,
_164            "packets_lost": 0,
_164            "packets_loss_percentage": 0.0,
_164            "jitter": {
_164              "max": 5.60994,
_164              "avg": 0.933334
_164            }
_164          },
_164          "outbound": {
_164            "codec": 0,
_164            "codec_name": "pcmu",
_164            "packets_sent": 229,
_164            "packets_lost": 0,
_164            "packets_loss_percentage": 0.0,
_164            "jitter": {
_164              "max": 0.960786,
_164              "avg": 0.399859
_164            }
_164          }
_164        }
_164      },
_164      "carrier_edge": null,
_164      "tags": [
_164        "high_pdd"
_164      ],
_164      "attributes": {
_164        "conference_participant": false
_164      },
_164      "properties": {
_164        "last_sip_response_num": 200,
_164        "pdd_ms": 58,
_164        "disconnected_by": "callee",
_164        "direction": "inbound"
_164      },
_164      "trust": null,
_164      "annotation": null,
_164      "url": "https://insights.twilio.com/v1/Voice/Summaries"
_164    },
_164    {
_164      "call_sid": "CAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_164      "account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_164      "created_time": "2021-08-25T04:16:35Z",
_164      "start_time": "2021-08-25T04:16:37Z",
_164      "end_time": "2021-08-25T04:16:40Z",
_164      "duration": 5,
_164      "connect_duration": 3,
_164      "call_type": "client",
_164      "call_state": "completed",
_164      "answered_by": "machine_start",
_164      "from": {
_164        "caller": "+15555555555",
_164        "carrier": "Verizon",
_164        "connection": "landline",
_164        "number_prefix": "1555",
_164        "location": {
_164          "lat": 40.83885,
_164          "lon": -74.04568
_164        },
_164        "country_code": "US"
_164      },
_164      "to": {
_164        "callee": "client:TBBTXXXXXX",
_164        "connection": "twilio_sdk"
_164      },
_164      "processing_state": "complete",
_164      "sdk_edge": null,
_164      "sip_edge": null,
_164      "client_edge": {
_164        "properties": {
_164          "media_region": "us1",
_164          "signaling_region": "us1",
_164          "twilio_media_ip": "54.xxx.xx.xxx",
_164          "external_media_ip": "54.xxx.xx.xxx",
_164          "edge_location": "xxxxx",
_164          "direction": "outbound"
_164        },
_164        "metrics": {
_164          "inbound": {
_164            "codec": 0,
_164            "codec_name": "pcmu",
_164            "packets_received": 110,
_164            "packets_lost": 0,
_164            "packets_loss_percentage": 0.0,
_164            "jitter": {
_164              "max": 1.05918,
_164              "avg": 0.461966
_164            }
_164          },
_164          "outbound": {
_164            "codec": 0,
_164            "codec_name": "pcmu",
_164            "packets_sent": 147,
_164            "packets_lost": 0,
_164            "packets_loss_percentage": 0.0,
_164            "jitter": {
_164              "max": 0.869174,
_164              "avg": 0.319674
_164            }
_164          }
_164        }
_164      },
_164      "carrier_edge": null,
_164      "tags": null,
_164      "attributes": {
_164        "conference_participant": false
_164      },
_164      "properties": {
_164        "last_sip_response_num": 200,
_164        "pdd_ms": 35,
_164        "disconnected_by": "callee",
_164        "direction": "outbound_api"
_164      },
_164      "trust": null,
_164      "annotation": null,
_164      "url": "https://insights.twilio.com/v1/Voice/Summaries"
_164    }
_164  ]
_164}

Read multiple Call Summaries for outbound calls signed with SHAKEN/STIR

Node.js

Python

Java

PHP

Ruby

twilio-cli

curl


_15// Download the helper library from https://www.twilio.com/docs/node/install
_15// Find your Account SID and Auth Token at twilio.com/console
_15// and set the environment variables. See http://twil.io/secure
_15const accountSid = process.env.TWILIO_ACCOUNT_SID;
_15const authToken = process.env.TWILIO_AUTH_TOKEN;
_15const client = require('twilio')(accountSid, authToken);
_15
_15client.insights.v1.callSummaries
_15      .list({
_15         startTime: '1d',
_15         verifiedCaller: true,
_15         direction: 'outbound_api,outbound_dial,trunking_terminating',
_15         limit: 20
_15       })
_15      .then(callSummaries => callSummaries.forEach(c => console.log(c.to)));

Output


_260{
_260  "meta": {
_260    "page": 0,
_260    "page_size": 25,
_260    "first_page_url": "https://insights.twilio.com/v1/Voice/Summaries?Direction=outbound_api%2Coutbound_dial%2Ctrunking_terminating&StartTime=1d&VerifiedCaller=True&PageSize=25&Page=0",
_260    "previous_page_url": "https://insights.twilio.com/v1/Voice/Summaries?Direction=outbound_api%2Coutbound_dial%2Ctrunking_terminating&StartTime=1d&VerifiedCaller=True&PageSize=25&Page=0",
_260    "next_page_url": "https://insights.twilio.com/v1/Voice/Summaries?Direction=outbound_api%2Coutbound_dial%2Ctrunking_terminating&StartTime=1d&VerifiedCaller=True&PageSize=25&Page=1",
_260    "key": "call_summaries",
_260    "url": "https://insights.twilio.com/v1/Voice/Summaries?Direction=outbound_api%2Coutbound_dial%2Ctrunking_terminating&StartTime=1d&VerifiedCaller=True&PageSize=25&Page=0"
_260  },
_260  "call_summaries": [
_260    {
_260      "call_sid": "CAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_260      "account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_260      "created_time": "2021-08-25T14:31:18Z",
_260      "start_time": "2021-08-25T14:31:22Z",
_260      "end_time": "2021-08-25T14:32:02Z",
_260      "duration": 44,
_260      "connect_duration": 41,
_260      "call_type": "trunking",
_260      "call_state": "completed",
_260      "answered_by": "machine_start",
_260      "from": {
_260        "caller": "+15555555555",
_260        "carrier": "ACS",
_260        "connection": "landline",
_260        "number_prefix": "1555",
_260        "location": {
_260          "lat": 60.268353,
_260          "lon": -141.13632
_260        },
_260        "country_code": "US"
_260      },
_260      "to": {
_260        "callee": "+15555555556",
_260        "carrier": "Hawaiian Telcom, Inc. - HI",
_260        "connection": "landline",
_260        "number_prefix": "1555",
_260        "location": {
_260          "lat": 20.956036,
_260          "lon": -157.23793
_260        },
_260        "country_code": "US"
_260      },
_260      "processing_state": "complete",
_260      "sdk_edge": null,
_260      "sip_edge": {
_260        "properties": {
_260          "media_region": "us1",
_260          "signaling_region": "us1",
_260          "twilio_media_ip": "54.xxx.xx.xx",
_260          "twilio_signaling_ip": "54.xxx.xx.xx",
_260          "external_signaling_ip": "54.xxx.xx.xx",
_260          "sip_call_id": "xxxxx@0.0.0.0",
_260          "user_agent": "xxxx",
_260          "edge_location": "xxxxx",
_260          "trunk_sid": "xxxxxxx",
_260          "direction": "inbound"
_260        },
_260        "metrics": {
_260          "outbound": {
_260            "codec": 0,
_260            "codec_name": "pcmu",
_260            "packets_sent": 1953,
_260            "packets_lost": 0,
_260            "packets_loss_percentage": 0.0,
_260            "jitter": {
_260              "max": 1.76407,
_260              "avg": 0.23138
_260            },
_260            "latency": {
_260              "max": 0.386,
_260              "avg": 0.3765
_260            }
_260          }
_260        }
_260      },
_260      "client_edge": null,
_260      "carrier_edge": {
_260        "properties": {
_260          "media_region": "us1",
_260          "signaling_region": "us1",
_260          "edge_location": "xxxx",
_260          "direction": "outbound"
_260        }
_260      },
_260      "tags": [
_260        "silence"
_260      ],
_260      "attributes": {
_260        "conference_participant": false
_260      },
_260      "properties": {
_260        "last_sip_response_num": 200,
_260        "pdd_ms": 1990,
_260        "disconnected_by": "caller",
_260        "direction": "trunking_terminating"
_260      },
_260      "trust": {
_260        "verified_caller": {
_260          "verified": true
_260        }
_260      },
_260      "annotation": null,
_260      "url": "https://insights.twilio.com/v1/Voice/Summaries"
_260    },
_260    {
_260      "call_sid": "CAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_260      "account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_260      "created_time": "2021-08-25T14:03:31Z",
_260      "start_time": "2021-08-25T14:03:32Z",
_260      "end_time": "2021-08-25T14:03:38Z",
_260      "duration": 7,
_260      "connect_duration": 6,
_260      "call_type": "carrier",
_260      "call_state": "completed",
_260      "answered_by": "machine_start",
_260      "from": {
_260        "caller": "+15555555555",
_260        "carrier": "T-Mobile USA, Inc.",
_260        "connection": "mobile",
_260        "number_prefix": "1555",
_260        "location": {
_260          "lat": 40.83885,
_260          "lon": -74.04568
_260        },
_260        "country_code": "US"
_260      },
_260      "to": {
_260        "callee": "+15555555556",
_260        "carrier": "T-Mobile USA, Inc.",
_260        "connection": "mobile",
_260        "number_prefix": "1555",
_260        "location": {
_260          "lat": 34.186115,
_260          "lon": -118.43555
_260        },
_260        "country_code": "US"
_260      },
_260      "processing_state": "complete",
_260      "sdk_edge": null,
_260      "sip_edge": null,
_260      "client_edge": null,
_260      "carrier_edge": {
_260        "properties": {
_260          "media_region": "us1",
_260          "signaling_region": "us1",
_260          "edge_location": "xxxx",
_260          "direction": "outbound"
_260        },
_260        "metrics": {
_260          "inbound": {
_260            "codec": 0,
_260            "codec_name": "pcmu",
_260            "packets_received": 229,
_260            "packets_lost": 0,
_260            "packets_loss_percentage": 0.0,
_260            "jitter": {
_260              "max": 1.10303,
_260              "avg": 0.449886
_260            }
_260          },
_260          "outbound": {
_260            "codec": 0,
_260            "codec_name": "pcmu",
_260            "packets_sent": 273,
_260            "packets_lost": 0,
_260            "packets_loss_percentage": 0.0,
_260            "jitter": {
_260              "max": 0.410031,
_260              "avg": 0.295951
_260            }
_260          }
_260        }
_260      },
_260      "tags": null,
_260      "attributes": {
_260        "conference_participant": false
_260      },
_260      "properties": {
_260        "last_sip_response_num": 200,
_260        "pdd_ms": 315,
_260        "disconnected_by": "callee",
_260        "direction": "outbound_api"
_260      },
_260      "trust": {
_260        "verified_caller": {
_260          "verified": true
_260        }
_260      },
_260      "annotation": null,
_260      "url": "https://insights.twilio.com/v1/Voice/Summaries"
_260    },
_260    {
_260      "call_sid": "CAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_260      "account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_260      "created_time": "2021-08-24T22:28:17Z",
_260      "start_time": "2021-08-24T22:28:20Z",
_260      "end_time": "2021-08-24T22:28:23Z",
_260      "duration": 4,
_260      "connect_duration": 3,
_260      "call_type": "carrier",
_260      "call_state": "completed",
_260      "answered_by": "machine_start",
_260      "from": {
_260        "caller": "+15555555555",
_260        "carrier": "Hawaiian Telcom, Inc. - HI",
_260        "connection": "landline",
_260        "number_prefix": "1555",
_260        "location": {
_260          "lat": 20.956036,
_260          "lon": -157.23793
_260        },
_260        "country_code": "US"
_260      },
_260      "to": {
_260        "callee": "+15555555556",
_260        "connection": "pstn"
_260      },
_260      "processing_state": "complete",
_260      "sdk_edge": null,
_260      "sip_edge": null,
_260      "client_edge": null,
_260      "carrier_edge": {
_260        "properties": {
_260          "media_region": "us1",
_260          "signaling_region": "us1",
_260          "edge_location": "xxxx",
_260          "direction": "outbound"
_260        },
_260        "metrics": {
_260          "outbound": {
_260            "codec": 0,
_260            "codec_name": "pcmu",
_260            "packets_sent": 103,
_260            "packets_lost": 0,
_260            "packets_loss_percentage": 0.0,
_260            "jitter": {
_260              "max": 0.596712,
_260              "avg": 0.251725
_260            }
_260          }
_260        }
_260      },
_260      "tags": [
_260        "silence"
_260      ],
_260      "attributes": null,
_260      "properties": {
_260        "last_sip_response_num": 200,
_260        "pdd_ms": 105,
_260        "disconnected_by": "caller",
_260        "direction": "outbound_dial"
_260      },
_260      "trust": null,
_260      "annotation": null,
_260      "url": "https://insights.twilio.com/v1/Voice/Summaries"
_260    }
_260  ]
_260}

Read multiple Call Summaries for SIP calls which did not end in 200 OK

Node.js

Python

Java

PHP

Ruby

twilio-cli

curl


_16// Download the helper library from https://www.twilio.com/docs/node/install
_16// Find your Account SID and Auth Token at twilio.com/console
_16// and set the environment variables. See http://twil.io/secure
_16const accountSid = process.env.TWILIO_ACCOUNT_SID;
_16const authToken = process.env.TWILIO_AUTH_TOKEN;
_16const client = require('twilio')(accountSid, authToken);
_16
_16client.insights.v1.callSummaries
_16      .list({
_16         startTime: '15d',
_16         abnormalSession: true,
_16         callState: 'completed',
_16         callType: 'sip,trunking',
_16         limit: 20
_16       })
_16      .then(callSummaries => callSummaries.forEach(c => console.log(c.to)));

Output


_189{
_189  "meta": {
_189    "page": 0,
_189    "page_size": 25,
_189    "first_page_url": "https://insights.twilio.com/v1/Voice/Summaries?CallType=sip%2Ctrunking&CallState=completed&StartTime=15d&AbnormalSession=True&PageSize=25&Page=0",
_189    "previous_page_url": "https://insights.twilio.com/v1/Voice/Summaries?CallType=sip%2Ctrunking&CallState=completed&StartTime=15d&AbnormalSession=True&PageSize=25&Page=0",
_189    "next_page_url": "https://insights.twilio.com/v1/Voice/Summaries?CallType=sip%2Ctrunking&CallState=completed&StartTime=15d&AbnormalSession=True&PageSize=25&Page=1",
_189    "key": "call_summaries",
_189    "url": "https://insights.twilio.com/v1/Voice/Summaries?CallType=sip%2Ctrunking&CallState=completed&StartTime=15d&AbnormalSession=True&PageSize=25&Page=0"
_189  },
_189  "call_summaries": [
_189    {
_189      "call_sid": "CAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_189      "account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_189      "created_time": "2021-08-25T14:46:40Z",
_189      "start_time": "2021-08-25T14:46:40Z",
_189      "end_time": "2021-08-25T14:46:52Z",
_189      "duration": 12,
_189      "connect_duration": 12,
_189      "call_type": "sip",
_189      "call_state": "completed",
_189      "answered_by": "machine_start",
_189      "from": {
_189        "caller": "+15555555555",
_189        "carrier": "XO Communications, Inc.",
_189        "connection": "landline",
_189        "number_prefix": "1555",
_189        "location": {
_189          "lat": 40.83885,
_189          "lon": -74.04568
_189        },
_189        "country_code": "US"
_189      },
_189      "to": {
_189        "callee": "sip:xxxx@xx.xxx.xx.xxx",
_189        "connection": "sip_interface"
_189      },
_189      "processing_state": "complete",
_189      "sdk_edge": null,
_189      "sip_edge": {
_189        "properties": {
_189          "media_region": "us1",
_189          "signaling_region": "us1",
_189          "twilio_media_ip": "xx.xxx.xx.xxx",
_189          "twilio_signaling_ip": "xx.xx.xx.xx",
_189          "external_media_ip": "xx.xxx.xx.xxx",
_189          "external_signaling_ip": "xx.xxx.xx.xxx",
_189          "sip_call_id": "xxxxxxxx@0.0.0.0",
_189          "edge_location": "xxxxx",
_189          "direction": "outbound"
_189        },
_189        "metrics": {
_189          "inbound": {
_189            "codec": 0,
_189            "codec_name": "pcmu",
_189            "packets_received": 525,
_189            "packets_lost": 0,
_189            "packets_loss_percentage": 0.0,
_189            "jitter": {
_189              "max": 0.554729,
_189              "avg": 0.229541
_189            }
_189          },
_189          "outbound": {
_189            "codec": 0,
_189            "codec_name": "pcmu",
_189            "packets_sent": 245,
_189            "packets_lost": 0,
_189            "packets_loss_percentage": 0.0,
_189            "jitter": {
_189              "max": 1.03548,
_189              "avg": 0.344092
_189            }
_189          }
_189        }
_189      },
_189      "client_edge": null,
_189      "carrier_edge": null,
_189      "tags": null,
_189      "attributes": {
_189        "conference_participant": false
_189      },
_189      "properties": {
_189        "last_sip_response_num": 200,
_189        "pdd_ms": 255,
_189        "disconnected_by": "callee",
_189        "direction": "outbound_dial"
_189      },
_189      "trust": null,
_189      "annotation": null,
_189      "url": "https://insights.twilio.com/v1/Voice/Summaries"
_189    },
_189    {
_189      "call_sid": "CAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_189      "account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_189      "created_time": "2021-08-25T14:31:18Z",
_189      "start_time": "2021-08-25T14:31:22Z",
_189      "end_time": "2021-08-25T14:32:02Z",
_189      "duration": 44,
_189      "connect_duration": 41,
_189      "call_type": "trunking",
_189      "call_state": "completed",
_189      "answered_by": "machine_start",
_189      "from": {
_189        "caller": "+15555555555",
_189        "carrier": "ACS",
_189        "connection": "landline",
_189        "number_prefix": "1555",
_189        "location": {
_189          "lat": 60.268353,
_189          "lon": -141.13632
_189        },
_189        "country_code": "US"
_189      },
_189      "to": {
_189        "callee": "+15555555556",
_189        "carrier": "Hawaiian Telcom, Inc. - HI",
_189        "connection": "landline",
_189        "number_prefix": "1555",
_189        "location": {
_189          "lat": 20.956036,
_189          "lon": -157.23793
_189        },
_189        "country_code": "US"
_189      },
_189      "processing_state": "complete",
_189      "sdk_edge": null,
_189      "sip_edge": {
_189        "properties": {
_189          "media_region": "us1",
_189          "signaling_region": "us1",
_189          "twilio_media_ip": "54.xxx.xx.xx",
_189          "twilio_signaling_ip": "54.xxx.xx.xx",
_189          "external_signaling_ip": "54.xxx.xx.xx",
_189          "sip_call_id": "xxxxx@0.0.0.0",
_189          "user_agent": "xxxx",
_189          "edge_location": "xxxxx",
_189          "trunk_sid": "xxxxxxx",
_189          "direction": "inbound"
_189        },
_189        "metrics": {
_189          "outbound": {
_189            "codec": 0,
_189            "codec_name": "pcmu",
_189            "packets_sent": 1953,
_189            "packets_lost": 0,
_189            "packets_loss_percentage": 0.0,
_189            "jitter": {
_189              "max": 1.76407,
_189              "avg": 0.23138
_189            },
_189            "latency": {
_189              "max": 0.386,
_189              "avg": 0.3765
_189            }
_189          }
_189        }
_189      },
_189      "client_edge": null,
_189      "carrier_edge": {
_189        "properties": {
_189          "media_region": "us1",
_189          "signaling_region": "us1",
_189          "edge_location": "xxxx",
_189          "direction": "outbound"
_189        }
_189      },
_189      "tags": [
_189        "silence"
_189      ],
_189      "attributes": {
_189        "conference_participant": false
_189      },
_189      "properties": {
_189        "last_sip_response_num": 200,
_189        "pdd_ms": 1990,
_189        "disconnected_by": "caller",
_189        "direction": "trunking_terminating"
_189      },
_189      "trust": {
_189        "verified_caller": {
_189          "verified": true
_189        }
_189      },
_189      "annotation": null,
_189      "url": "https://insights.twilio.com/v1/Voice/Summaries"
_189    }
_189  ]
_189}

Read multiple Call Summaries with annotations

Node.js

Python

Java

PHP

Ruby

twilio-cli

curl


_18// Download the helper library from https://www.twilio.com/docs/node/install
_18// Find your Account SID and Auth Token at twilio.com/console
_18// and set the environment variables. See http://twil.io/secure
_18const accountSid = process.env.TWILIO_ACCOUNT_SID;
_18const authToken = process.env.TWILIO_AUTH_TOKEN;
_18const client = require('twilio')(accountSid, authToken);
_18
_18client.insights.v1.callSummaries
_18      .list({
_18         startTime: '15d',
_18         answeredBy: 'human',
_18         callScoreAnnotation: '1',
_18         connectivityIssueAnnotation: 'no_connectivity_issue',
_18         qualityIssueAnnotation: 'latency',
_18         spamAnnotation: ,
_18         limit: 20
_18       })
_18      .then(callSummaries => callSummaries.forEach(c => console.log(c.to)));

Output


_190{
_190  "meta": {
_190    "page": 0,
_190    "page_size": 25,
_190    "first_page_url": "https://insights.twilio.com/v1/Voice/Summaries?ToCarrier=AT%26T+Wireless&AnsweredBy=machine_start&StartTime=4h&PageSize=25&Page=0",
_190    "previous_page_url": "https://insights.twilio.com/v1/Voice/Summaries?ToCarrier=AT%26T+Wireless&AnsweredBy=machine_start&StartTime=4h&PageSize=25&Page=0",
_190    "next_page_url": "https://insights.twilio.com/v1/Voice/Summaries?ToCarrier=AT%26T+Wireless&AnsweredBy=machine_start&StartTime=4h&PageSize=25&Page=1",
_190    "key": "call_summaries",
_190    "url": "https://insights.twilio.com/v1/Voice/Summaries?ToCarrier=AT%26T+Wireless&AnsweredBy=machine_start&StartTime=4h&PageSize=25&Page=0"
_190  },
_190  "call_summaries": [
_190    {
_190      "call_sid": "CAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_190      "account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_190      "created_time": "2021-08-25T03:40:25Z",
_190      "start_time": "2021-08-25T03:40:25Z",
_190      "end_time": "2021-08-25T03:40:45Z",
_190      "duration": 20,
_190      "connect_duration": 20,
_190      "call_type": "carrier",
_190      "call_state": "completed",
_190      "answered_by": "machine_start",
_190      "from": {
_190        "caller": "+15555555555",
_190        "carrier": "T-Mobile USA, Inc.",
_190        "connection": "mobile",
_190        "number_prefix": "1555",
_190        "location": {
_190          "lat": 40.83885,
_190          "lon": -74.04568
_190        },
_190        "country_code": "US"
_190      },
_190      "to": {
_190        "callee": "+15555555556",
_190        "carrier": "AT&T Wireless",
_190        "connection": "mobile",
_190        "number_prefix": "1555",
_190        "location": {
_190          "lat": 33.42767,
_190          "lon": -86.886475
_190        },
_190        "country_code": "US"
_190      },
_190      "processing_state": "complete",
_190      "sdk_edge": null,
_190      "sip_edge": null,
_190      "client_edge": null,
_190      "carrier_edge": {
_190        "properties": {
_190          "media_region": "us1",
_190          "signaling_region": "us1",
_190          "edge_location": "xxxxx",
_190          "direction": "inbound"
_190        },
_190        "metrics": {
_190          "inbound": {
_190            "codec": 0,
_190            "codec_name": "pcmu",
_190            "packets_received": 202,
_190            "packets_lost": 0,
_190            "packets_loss_percentage": 0.0,
_190            "jitter": {
_190              "max": 1.48209,
_190              "avg": 0.483035
_190            }
_190          },
_190          "outbound": {
_190            "codec": 0,
_190            "codec_name": "pcmu",
_190            "packets_sent": 218,
_190            "packets_lost": 0,
_190            "packets_loss_percentage": 0.0,
_190            "jitter": {
_190              "max": 0.51868,
_190              "avg": 0.364434
_190            }
_190          }
_190        }
_190      },
_190      "tags": [
_190        "high_packet_loss",
_190        "high_jitter"
_190      ],
_190      "attributes": {
_190        "conference_participant": false
_190      },
_190      "properties": {
_190        "last_sip_response_num": 200,
_190        "pdd_ms": 121,
_190        "disconnected_by": "callee",
_190        "direction": "inbound"
_190      },
_190      "trust": {
_190        "verified_caller": {
_190          "verified": true
_190        }
_190      },
_190      "annotation": null,
_190      "url": "https://insights.twilio.com/v1/Voice/Summaries"
_190    },
_190    {
_190      "call_sid": "CAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_190      "account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_190      "created_time": "2021-08-25T02:20:25Z",
_190      "start_time": "2021-08-25T02:20:25Z",
_190      "end_time": "2021-08-25T02:40:45Z",
_190      "duration": 18,
_190      "connect_duration": 18,
_190      "call_type": "carrier",
_190      "call_state": "completed",
_190      "answered_by": "machine_start",
_190      "from": {
_190        "caller": "+15555555555",
_190        "carrier": "T-Mobile USA, Inc.",
_190        "connection": "mobile",
_190        "number_prefix": "1555",
_190        "location": {
_190          "lat": 40.83885,
_190          "lon": -74.04568
_190        },
_190        "country_code": "US"
_190      },
_190      "to": {
_190        "callee": "+15555555556",
_190        "carrier": "AT&T Wireless",
_190        "connection": "mobile",
_190        "number_prefix": "1555",
_190        "location": {
_190          "lat": 33.42767,
_190          "lon": -86.886475
_190        },
_190        "country_code": "US"
_190      },
_190      "processing_state": "complete",
_190      "sdk_edge": null,
_190      "sip_edge": null,
_190      "client_edge": null,
_190      "carrier_edge": {
_190        "properties": {
_190          "media_region": "us1",
_190          "signaling_region": "us1",
_190          "edge_location": "xxxxx",
_190          "direction": "inbound"
_190        },
_190        "metrics": {
_190          "inbound": {
_190            "codec": 0,
_190            "codec_name": "pcmu",
_190            "packets_received": 100,
_190            "packets_lost": 0,
_190            "packets_loss_percentage": 0.0,
_190            "jitter": {
_190              "max": 1.48209,
_190              "avg": 0.483035
_190            }
_190          },
_190          "outbound": {
_190            "codec": 0,
_190            "codec_name": "pcmu",
_190            "packets_sent": 102,
_190            "packets_lost": 0,
_190            "packets_loss_percentage": 0.0,
_190            "jitter": {
_190              "max": 0.51868,
_190              "avg": 0.364434
_190            }
_190          }
_190        }
_190      },
_190      "tags": null,
_190      "attributes": {
_190        "conference_participant": false
_190      },
_190      "properties": {
_190        "last_sip_response_num": 200,
_190        "pdd_ms": 121,
_190        "disconnected_by": "callee",
_190        "direction": "inbound"
_190      },
_190      "trust": {
_190        "verified_caller": {
_190          "verified": true
_190        }
_190      },
_190      "annotation": null,
_190      "url": "https://insights.twilio.com/v1/Voice/Summaries"
_190    }
_190  ]
_190}