Overview
Welcome to the Billing Usage Insights Getting Started Guide. This guide explains what Billing Usage Insights provides, how to access it, which reports are available, and which capabilities are available to all customers versus those included with Twilio Enterprise Edition.
Environment
Twilio Console
What You Need to Know
What is Billing Usage Insights?
Billing Usage Insights is Twilio's spend and usage analytics experience. It provides reports and dashboards that break down what you are spending on which products, so you can investigate unexpected charges, monitor spend patterns over time, and understand what is driving your bill.
Billing Insights is available to all Twilio customers in two versions. The free version, available to everyone, provides core reporting across recent time periods. The paid version, included with Twilio Enterprise Edition, adds the analytical depth needed for deeper spend analysis: a broader filter set, flexible date-range selection, and access to up to a year of history.
Availability: Billing Insights is currently available in the United States region.
Accessing Billing Usage Insights
In the left navigation of Console one, the credit card icon gives you access to billing surfaces. Billing Usage Insights sits under Account Usage, which is scoped to the Account SID you currently have selected.
Navigation path: Left navigation → Billing (credit card icon) → Account Usage → Billing Usage Insights
How the Page is Organized
The Billing Insights main dashboard is organized into three areas.
1. Filter controls:
Where you scope the data you want to review. Today this area contains date-range filters (e.g. last 24 hours, or last 7, 14, or 30 days), available in both free and paid versions.
2. At-a-glance evaluation:
A summary view showing your total spend and a breakdown of spend by SKU group. This is the same in both versions, and it is the fastest way to confirm whether overall spend looks as expected before deciding whether to dig further.
3. Detailed reporting:
Where investigation happens. This area provides a set of reports covering spend and usage from different angles. Each report supports drill-down into more specific detail, allowing you to move from an aggregate figure to the underlying usage details behind it. The drill-down view provides additional report-specific filters, category, phone number, quantity, and others, which are available only to Enterprise Edition customers.
- Usage Summary: An overview of total spend with Usage Categories breakdown and Billable Item Level details.
- Spend by top-level SKU group: An overview of spend with SKU Group breakdown and Billable Item level details.
- Programmable SMS spend: A dedicated view of messaging spend with To/From details.
- Programmable Voice spend: A dedicated view of voice spend with To/From details.
- Other usage spend: Spend across usage categories outside of programmable voice and programmable messaging.
- Usage quantity by category: Consumption volumes rather than dollar amounts, useful for understanding activity levels independent of price.
The report list
In addition to the three areas above, you can open the full report list from the link in the top right corner of the Billing Insights page. This lets you browse all available reports and open a specific one directly, without navigating through the dashboard.
Advanced Billing Insights (Twilio Enterprise Edition)
Customers on Twilio Enterprise Edition have access to Advanced Billing Insights, which adds analytical depth on top of the reports above:
- Extended historical data. Analyze spend across longer time periods up to a year than the standard 30-day window, making it possible to compare across months and identify recurring patterns.
- Flexible date-range operators. Rather than fixed lookback windows only, build date conditions using operators such as is on or before, is between, and is on or after to target a specific period.
- Additional report filters. Filter reports by dimensions including category, phone number, quantity, subaccount, transaction ID, billable item and more, allowing you to isolate spend down to a specific dimension rather than viewing category totals.
- Saved filters. Save a filter configuration so a recurring analysis can be reopened without rebuilding it. Saved configurations appear in the report list alongside the standard reports.
Free vs. Enterprise Edition at a glance
| Capability | All customers | Enterprise Edition |
| Standard reports (e.g. Usage Summary, Spend by top-level SKU group) | ✓ | ✓ |
| Fixed lookback windows (24 hours, 7, 14, 30 days) | ✓ | ✓ |
| Report drill-down | ✓ | ✓ |
| Include or exclude subaccounts | ✗ | ✓ |
| History beyond 30 days | ✗ | ✓ |
| Flexible date-range operators (on or before, between, on or after) | ✗ | ✓ |
| Filter specific reports by category, phone number, quantity, subaccount, transaction ID, billable item, and more | ✗ | ✓ |
| Save filter configurations | ✗ | ✓ |