Menu

Expand
Rate this page:

Call Events Resource

Get Call Events

The call events resource provides programmatic access to call progress and SDK events for a provided call SID. Call events are generated by call progress events and Voice SDK events. Events are typically available via the API within 90 seconds.

GET https://insights.twilio.com/v1/Voice/{SID}/Events
        
        
        
        

        Request Parameters

        Parameter options
        Edge carrier_edge, client_edge, sdk_edge, sip_edge
        PageSize Default 50

        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.

              
              
              
              

              Resource Properties

              Call events are represented by the following properties:

              Property Description
              account_sid The account SID this call belongs to
              call_sid Call SID for the call the events are associated with
              carrier_edge Represents the connection between Twilio and our immediate carrier partners. The events here describe the call lifecycle as reported by Twilio's carrier media gateways.
              client_edge Represents the Twilio media gateway for Client calls. The events here describe the call lifecycle as reported by Twilio's Voice SDK media gateways.
              edge The edge reporting the event
              group Event group
              level Detail level
              name Event name
              sdk_edge Represents the Voice SDK running locally in the browser or in the Android/iOS application. The events here are emitted by the Voice SDK in response to certain call progress events, network changes, or call quality conditions.
              sip_edge Represents the Twilio media gateway for SIP interface and SIP trunking calls. The events here describe the call lifecycle as reported by Twilio's public media gateways.
              timestamp Event time

              NOTE: Voice Insights for mobile SDKs is supported for versions 3.x and later. Calls placed using 2.x mobile SDKs are not supported and details are provided as-is and may not be reliable indicators of actual behavior on the handset.

              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 browsing the Twilio tag on Stack Overflow.

                    
                    
                    

                    Thank you for your feedback!

                    We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

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

                    Thanks for your feedback!

                    Refer us and get $10 in 3 simple steps!

                    Step 1

                    Get link

                    Get a free personal referral link here

                    Step 2

                    Give $10

                    Your user signs up and upgrade using link

                    Step 3

                    Get $10

                    1,250 free SMSes
                    OR 1,000 free voice mins
                    OR 12,000 chats
                    OR more