Skip to main content
The Usage page shows how much your organization consumed over a date range: call and chat volume, voice minutes and chat turns, workflow runs, plus a daily breakdown and your current inventory of agents, phone numbers, web widgets, and knowledge bases. Use it to see what is driving your bill and how activity trends day to day. Open it from Organization > Usage. The page requires the billing:manage scope; without it you see a no-access screen.

​
How the page works

The dashboard fetches a single summary for the selected date range:
The summary cards and charts reflect the date range you pick. The Inventory counts at the bottom are current totals and do not depend on the range.
The date range defaults to month-to-date: the 1st of the current month through today. The picker dates are treated as UTC, so the window you see matches what the dashboard queries.

​
Date range rules

A range over one year, or a to that is not after from, is rejected. The date picker also disables selections more than 365 days from the first picked date.

​
Summary metrics

These cards reflect activity inside the selected date range. A text conversation’s duration says little about its size, so chat is measured in user turns — the same unit chat is billed in. The full response also breaks calls down by channel and direction:
Average call duration is returned in seconds (avg_call_duration_sec) and rendered on the card in minutes and seconds.

​
Daily series

The response includes a daily array, one point per day in the range, that powers the charts. The dashboard renders these as per-day charts:

​
Inventory

Inventory cards show your organization’s current totals and ignore the selected date range.

​
Refreshing

Use the refresh control on the page to re-fetch the summary for the current range without changing the dates.

Plans and billing

See how this usage maps to your plan and invoices.