# Call Insights API Overview

The **Call Insights REST API** of [**Voice Insights**](/docs/voice/voice-insights) provides programmatic access to call summaries, call metrics and call quality related events for use in your own applications and tools. Subject to regional availability, you can also use it for call annotations to capture subjective call experience details.

In order to use the resources in this REST API, [Advanced Features](/docs/voice/voice-insights/advanced-features) has to be activated. You can use the [Voice Insights Settings Resource](/docs/voice/voice-insights/api/call/voice-insights-settings-resource) for programmatic activation or perform it manually in Console.

## Base URL

Call Insights data is available under the following base URL. The REST API is served over HTTPS; unencrypted HTTP is not supported.

```bash
https://insights.twilio.com/v1/Voice/
```

## Authentication

To authenticate requests to the Twilio APIs, Twilio supports [HTTP Basic authentication](https://en.wikipedia.org/wiki/Basic_access_authentication). Use your *API key* as the username and your *API key secret* as the password. You can create an API key either [in the Twilio Console](/docs/iam/api-keys/keys-in-console) or [using the API](/docs/iam/api-keys/key-resource-v1).

**Note**: Twilio recommends using API keys for authentication in production apps. For local testing, you can use your Account SID as the username and your Auth token as the password. You can find your Account SID and Auth Token in the [Twilio Console](https://www.twilio.com/console).

Learn more about [Twilio API authentication](/docs/usage/requests-to-twilio).

```bash
curl -G https://insights.twilio.com/v1/Voice/[CALL SID]/Summary \
    -u $TWILIO_API_KEY:$TWILIO_API_KEY_SECRET
```

## Resources

The following resources are available in the Call Insights REST API.

| **Resource**                                                                                                    | **Description**                                                                                   |
| --------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| [Call Summary Resource](/docs/voice/voice-insights/api/call/call-summary-resource) (single Call Summary)        | Get a call summary for a single call.                                                             |
| [Call Summaries Resource](/docs/voice/voice-insights/api/call/call-summaries-resource) (list of Call Summaries) | Get a list of call summaries for multiple calls.                                                  |
| [Call Events Resource](/docs/voice/voice-insights/api/call/call-events-resource)                                | Get call progress and quality-related Voice SDK events data for a specific call.                  |
| [Call Metrics Resource](/docs/voice/voice-insights/api/call/call-metrics-resource)                              | Get quality-related metrics for a specific call.                                                  |
| [Call Annotations Resource](/docs/voice/voice-insights/api/call/call-annotation-resource)                       | Annotate calls to provide subjective experience details. Get the annotations for a specific call. |
| [Settings Resource](/docs/voice/voice-insights/api/call/voice-insights-settings-resource)                       | Control Voice Insights Advanced Features and Voice Trace status for an account.                   |