Skip to main content
The Usage page shows how much your organization consumed over a date range: call and chat volume, voice and chat minutes, 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: 
GET https://api.anyreach.ai/admin/usage/summary?from={iso8601}&to={iso8601}
Authorization: Bearer <token>
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

RuleValue
to must be after fromRequired
Maximum range366 days
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.
CardFieldTypeWhat it shows
Voice Minutesvoice_minutesnumberTotal voice minutes; subtext shows voice_calls
Chat Minuteschat_minutesnumberTotal chat minutes; subtext shows chat_calls sessions
Total Callstotal_callsintegerAll calls; subtext shows inbound_calls in, outbound_calls out, and average duration
Workflow Runsworkflow_runs_totalintegerAll workflow runs; subtext shows workflow_runs_success and workflow_runs_failed
The full response also breaks calls down by channel and direction:
FieldTypeDescription
total_callsintegerAll conversations in the range
voice_callsintegerVoice conversations
chat_callsintegerChat conversations (shown as “sessions”)
inbound_callsintegerCalls received
outbound_callsintegerCalls placed
voice_minutesnumberTotal voice minutes
chat_minutesnumberTotal chat minutes
avg_call_duration_secnumberAverage call duration, in seconds
workflow_runs_totalintegerWorkflow runs started
workflow_runs_successintegerWorkflow runs that succeeded
workflow_runs_failedintegerWorkflow runs that failed
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.
FieldTypeDescription
daystringThe date for this point
callsintegerCalls that day
voice_minutesnumberVoice minutes that day
chat_minutesnumberChat minutes that day
workflow_runsintegerWorkflow runs that day
The dashboard renders these as per-day charts: 
Voice Minutes (line)   Chat Minutes (line)
Calls per day (bar)
Workflow runs per day (bar)  ← shown only when workflow_runs_total > 0

​
Inventory

Inventory cards show your organization’s current totals and ignore the selected date range.
CardFieldTypeDescription
Active Agentstotal_agentsintegerAgents in the organization
Phone Numberstotal_phone_numbersintegerPhone numbers; subtext shows shared_phone_numbers on the shared pool (billable) when above zero
Chat Widgets Deployedtotal_web_widgetsintegerWeb widgets
Knowledge Basestotal_datasetsintegerKnowledge bases; subtext shows active_datasets active

​
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.