Voice Insights REST API
The Voice Insights REST API provides access to an expanded set of the data available in our dashboard to use in your own applications and tools.
Call Event, Metric, and Summary access is available as part of Voice Insights advanced features which can be enabled here.
Calls with Voice Insights advanced features are charged at $0.0025 per minute.
Base URL
Voice Insights data is available under the following base URL. The REST API is served over HTTPS; unencrypted HTTP is not supported.
https://insights.twilio.com/v1/Voice/
Authentication
HTTP requests to the REST API are protected with HTTP Basic authentication. To learn more about how Twilio handles authentication, please refer to our security documentation. In short, you will use your Twilio account SID as the username and your auth token as the password for HTTP Basic authentication. You can find your account SID and auth token on the console home page.
curl -G https://insights.twilio.com/v1/Voice/[CALL SID]/Summary -u \
'[YOUR ACCOUNT SID]:[YOUR AUTH TOKEN]'
Subresources
The following resources are available in the Voice Insights REST API.
| Resource | Description |
|---|---|
| Call Summary Resources | Get detailed data on individual calls. |
| Call Events Resources | Retrieve call progress and SDK events. |
| Call Metrics Resources | View time series call quality metrics. |
| Call Annotation Resources (Beta) | Annotate calls to provide subjective experience details. |
| Settings API | Control Voice Insights Advanced Features and Voice Trace status on an account. |
| Conference Summary Resources | Get an overview of metadata and quality performance for a single conference. |
| Conference Participant Resources | Retrieve quality and behavior details about a conference participant. |
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.
