Usage Visibility
Usage data is available from the dashboard and from a small set of API endpoints. This page covers the operational surface — what your team can read programmatically. Pricing, contract terms, top-ups, and any change to billing configuration are handled by your account team — reach out to them on Slack or at [email protected].
Where to look in the dashboard
| Section | What's there |
|---|---|
| Organization → Billing | Current balance, recent activity, invoices |
| Analytics | Per-call detail (duration, status, transcript, post-call analysis) |
Programmatic visibility
Current balance
Code
Returns the balance in your account's billing currency plus a boolean has_credits signal. Use has_credits as a guard before triggering large outbound campaigns.
Usage summary
Code
Returns aggregated counts (calls + total minutes) for the requested window.
Daily breakdown
Code
Invoice list
Code
Low-balance signals
The platform raises in-app notifications and dashboard banners when your balance drops to a threshold your account team has configured for you. If you want changes to that threshold, the notification destination, or any automatic top-up behaviour, reach out to your account team — these are not exposed as self-service settings.
API reference
| Endpoint | Method | Purpose |
|---|---|---|
/v1/billing/balance | GET | Current balance + has_credits flag |
/v1/billing/usage | GET | Aggregated usage for a window |
/v1/billing/usage/daily | GET | Per-day breakdown |
/v1/billing/invoices | GET | Invoice list |
For SDK examples covering these endpoints, see the Python and TypeScript SDK references — client.billing.balance(), client.billing.usage(), client.billing.balance_history().
Next
- Production checklist — pre-launch operational verification
- Using API keys — manage API access for your billing scripts