Skip to main content

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.

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.