Skip to contentSkip to navigationSkip to topbar
Rate this page:
On this page

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

call-summary-properties page anchor

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.

Pattern:
^AC[0-9a-fA-F]{32}$
Min length:
34
Max length:
34

call_sidtype: SID<CA>

The unique SID identifier of the Call.

Pattern:
^CA[0-9a-fA-F]{32}$
Min length:
34
Max length:
34

answered_bytype: enum<string>

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(link takes you to an external page) for more detail.

Possible values:
unknownmachine_startmachine_end_beepmachine_end_silencemachine_end_otherhumanfax

call_typetype: enum<string>

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

Possible values:
carriersiptrunkingclient

call_statetype: enum<string>

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

Possible values:
ringingcompletedbusyfailnoanswercanceledansweredundialed

processing_statetype: enum<string>

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>

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>

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


end_timetype: string<date-time>

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


durationtype: integer

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


connect_durationtype: integer

Duration between when the call was answered and when it ended


fromtype: object

The calling party.


totype: object

The called party.


carrier_edgetype: object

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


client_edgetype: object

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


sdk_edgetype: object

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


sip_edgetype: object

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


tagstype: array[string]

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


urltype: string<uri>

The URL of this resource.


attributestype: object

Attributes capturing call-flow-specific details.


propertiestype: object

Contains edge-agnostic call-level details.


trusttype: object

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


annotationtype: null

Read multiple Call Summary resources

read-multiple-call-summary-resources page anchor
GET https://insights.twilio.com/v1/Voice/Summaries

Parameters

list-parameters page anchor
URI parameters
Fromtype: string
Query ParameterPII MTL: 30 days

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


Totype: string
Query ParameterPII MTL: 30 days

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


FromCarriertype: string
Query ParameterNot PII

An origination carrier.


ToCarriertype: string
Query ParameterNot PII

A destination carrier.


FromCountryCodetype: string
Query ParameterNot PII

A source country code based on phone number in From.


ToCountryCodetype: string
Query ParameterNot PII

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


Brandedtype: boolean
Query ParameterNot PII

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


VerifiedCallertype: boolean
Query ParameterNot PII

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


HasTagtype: boolean
Query ParameterNot PII

A boolean flag indicating the presence of one or more Voice Insights Call Tags(link takes you to an external page).


StartTimetype: string
Query ParameterNot PII

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: string
Query ParameterNot PII

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: string
Query ParameterNot PII

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


CallStatetype: string
Query ParameterNot PII

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


Directiontype: string
Query ParameterNot PII

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


ProcessingStatetype: enum<string>
Query ParameterNot PII

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

Possible values:
completedstartedpartialall

SortBytype: enum<string>
Query ParameterNot PII

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>
Query ParameterNot PII

A unique SID identifier of a Subaccount.

Pattern:
^AC[0-9a-fA-F]{32}$
Min length:
34
Max length:
34

AbnormalSessiontype: boolean
Query ParameterNot PII

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


AnsweredBytype: enum<string>
Query ParameterNot PII

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: string
Query ParameterNot PII

Either machine or human.


ConnectivityIssueAnnotationtype: string
Query ParameterNot PII

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


QualityIssueAnnotationtype: string
Query ParameterNot PII

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


SpamAnnotationtype: boolean
Query ParameterNot PII

A boolean flag indicating spam calls.


CallScoreAnnotationtype: string
Query ParameterNot PII

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: integer
Query ParameterNot PII

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

Minimum:
1

Pagetype: integer
Query ParameterNot PII

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

Minimum:
0

PageTokentype: string
Query ParameterNot PII

The page token. This is provided by the API.

Read multiple Call Summaries

read-multiple-call-summaries page anchor
Node.js
Python
C#
Java
Go
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
_10
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_10
const authToken = process.env.TWILIO_AUTH_TOKEN;
_10
const client = require('twilio')(accountSid, authToken);
_10
_10
client.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

read-multiple-call-summaries-from-tofrom-specific-carriers-for-a-data-range page anchor
Node.js
Python
C#
Java
Go
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
_10
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_10
const authToken = process.env.TWILIO_AUTH_TOKEN;
_10
const client = require('twilio')(accountSid, authToken);
_10
_10
client.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

read-multiple-call-summaries-from-a-subaccount-with-detected-issues page anchor
Node.js
Python
C#
Java
Go
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
_16
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_16
const authToken = process.env.TWILIO_AUTH_TOKEN;
_16
const client = require('twilio')(accountSid, authToken);
_16
_16
client.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

read-multiple-call-summaries-for-outbound-calls-signed-with-shakenstir page anchor
Node.js
Python
C#
Java
Go
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
_15
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_15
const authToken = process.env.TWILIO_AUTH_TOKEN;
_15
const client = require('twilio')(accountSid, authToken);
_15
_15
client.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

read-multiple-call-summaries-for-sip-calls-which-did-not-end-in-200-ok page anchor
Node.js
Python
C#
Java
Go
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
_16
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_16
const authToken = process.env.TWILIO_AUTH_TOKEN;
_16
const client = require('twilio')(accountSid, authToken);
_16
_16
client.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

read-multiple-call-summaries-with-annotations page anchor
Node.js
Python
C#
Java
Go
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
_18
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_18
const authToken = process.env.TWILIO_AUTH_TOKEN;
_18
const client = require('twilio')(accountSid, authToken);
_18
_18
client.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
}


Rate this page: