Skip to main content
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.