Menu

Expand
Rate this page:

Call Metrics Resource

Get Call Metrics

The call metrics resource provides an overview of metadata and quality metrics for a provided call. Metrics are typically available via API within 90 seconds.

GET https://insights.twilio.com/v1/Voice/{CALL_SID}/Metrics
Loading Code Sample...
        
        

        Get Call metrics

        Request Parameters

        Parameter options
        Edge carrier_edge, client_edge, sdk_edge, sip_edge
        PageSize Default 50
        Direction both, inbound, outbound. Note: metrics from sdk_edge will always be both

        If no Edge parameter is provided, the results will depend on the call type:

        Call Type Default Edge Additional Edge
        Carrier carrier_edge N/A
        SIP sip_edge N/A
        Client sdk_edge client_edge
        Trunking Originating carrier_edge sip_edge
        Trunking Terminating sip_edge carrier_edge

        See Understanding Twilio Media Edges for more information.

        Loading Code Sample...
              
              

              Get Call metrics for a specific edge

              Resource Properties

              A call metric sample is represented by the following properties:

              Property Description
              account_sid The account SID this call belongs to
              call_sid SID for the call
              carrier_edge Contains metrics and properties for the Twilio media gateway of a PSTN call
              client_edge Contains metrics and properties for the Twilio media gateway of a Client call
              direction Defines media stream direction from the perspective of the Twilio Media edge. Inbound or outbound
              edge Represents the Twilio Media Edge the metric was captured on
              sdk_edge Contains metrics and properties for the SDK sensor library for Client calls
              sip_edge Contains metrics and properties for the Twilio media gateway of a SIP Interface or Trunking call
              timestamp Timestamp of metric sample. Samples are taken every 10 seconds and contain the metrics for the previous 10 seconds.

              Edge metrics and properties

              Metric samples from these edges will contain the following properties:

              Property Description
              codec RTP profile number of the detected codec
              codec_name Name of the detected codec
              cumulative Cumulative jitter (max/avg), packets lost, and packet count for the stream received at this edge
              interval sdk_edge: audio in/out, jitter, packet loss, rtt, and packet loss percentage for the sampling interval. All other edges: packets received, packets lost, and packet loss percentage.
              metadata Twilio media region of the selected edge, Twilio and endpoint IP media IP addresses
              Rate this page:

              Need some help?

              We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.

              Loading Code Sample...
                    
                    
                    

                    Thank you for your feedback!

                    Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

                    Sending your feedback...
                    🎉 Thank you for your feedback!
                    Something went wrong. Please try again.

                    Thanks for your feedback!

                    thanks-feedback-gif