> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getbutter.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Analytics Overview

> Understand your usage, costs, and agent performance.

The Butter AI analytics API gives you visibility into how your voice agents perform. You can track call volume, view component-level costs, and see which agents handle the most traffic.

All endpoints require the `CALLS_READ` permission.

### Date Range Filtering

Every analytics endpoint supports filtering by date or exact time. You have two options for defining your time window:

1. **Daily Granularity (Default):** Use `start_date` and `end_date` in `YYYY-MM-DD` format. This returns data aggregated by day. If you omit both, the API defaults to the last 30 days.
2. **Minute Granularity:** Use `start_datetime` and `end_datetime` in ISO 8601 format (e.g., `2024-03-01T14:30:00Z`). This returns data for precise sub-day ranges and changes the aggregation to per-minute.

### Available Endpoints

* **Summary:** High-level totals for calls, spend, and credits over a period.
* **Daily Calls:** Time-series data showing call volume and cost trends.
* **Daily Spend:** Time-series data tracking credit usage over time.
* **Agents:** Performance metrics grouped by individual agent.
* **Providers:** Cost and volume breakdown across different infrastructure providers.

For dashboards needing all metrics at once, you can also fetch the compound `/api/analytics/all` endpoint which returns all the above data in a single response.