Skip to main content

​
Overview

Settings > Usage is the full transaction-level record of everything that has moved through your account’s billing balances — every call charge, top-up, refund, credit refresh, and adjustment. It’s split into two tabs, because Voxworks tracks two separate balances:
  • Wallet Usage — the dollar ledger behind your Wallet Balance: top-ups, call charges, overage, refunds, and adjustments.
  • Minute Usage — the ledger behind your plan’s included minutes, for Trial and monthly-plan accounts only: allocations, monthly refreshes, tier changes, and manual adjustments.
Which tab has entries in it depends on your plan. Pay As You Go accounts have no minute credits, so their Minute Usage tab stays empty and all activity shows up under Wallet Usage. Trial and monthly-plan accounts populate both — minute credits are drawn down first, and only overage beyond your included minutes shows up as a charge in Wallet Usage. See How Call Billing Works for that order of operations. Both tabs load up to 100 entries for the selected billing period, most recent first.

​
Wallet Usage tab

Each row shows the date and time of the entry, a description, the amount, and your Wallet Balance immediately after the entry was applied (“Balance”). A coloured badge next to the description identifies the entry type: Amounts are shown as dollars: credits (top-ups, refunds) are prefixed with +, debits (usage, overage) with -. If a period has no activity, the tab shows “No wallet entries found for this period” instead of a table.

​
Minute Usage tab

This tab only has entries for Trial and monthly-plan accounts — Pay As You Go accounts don’t have minute credits, so it shows “No usage found for this period.” Each row shows the date and time, a description, an action type badge, the batch a call belonged to (if any), the duration of minutes moved, and the minute balance remaining after the entry. The Batch column shows the name of the batch the call belonged to, where applicable, and shows ”-” for entries not tied to a batch (top-ups, refreshes, tier changes, and calls placed outside a batch).

​
Choosing a billing period

Both tabs share the same period control in the top-right of the card: a Current Period / Previous Period toggle (a dropdown of the same two options on narrow screens). Switching periods reloads both the Wallet Usage and Minute Usage tabs at once. Periods run by calendar month — the 1st through the last day of the month — rather than your subscription’s billing anniversary date.

​
Downloading a CSV

The Download CSV button next to the period control exports whichever tab is currently active, for the currently selected period. It’s disabled while data is loading or when the active tab has no entries for the period.
  • Wallet Usage exports as wallet-usage-{period}-{date}.csv with columns: Date, Time, Type, Description, Amount (cents), Balance After (cents).
  • Minute Usage exports as minute-usage-{period}-{date}.csv with columns: Date, Time, Action Type, Description, Batch, Duration, Balance Remaining, Metadata (raw entry metadata as JSON).
Amounts in the Wallet Usage CSV are in cents rather than dollars, and durations in the Minute Usage CSV are written out as e.g. 2m 30s rather than raw seconds.

​
How ledger entries map to the billing model

Every entry on this page traces back to the billing rules covered in How Call Billing Works:
  • A call first draws down your plan’s minute credits (a call_usage entry in Minute Usage). Once those credits are exhausted, the remaining cost is charged to your wallet as an Overage entry in Wallet Usage. Pay As You Go accounts skip credits entirely — every call is a Usage entry straight to the wallet.
  • Topup and Refund entries reflect money moving in and out of your Wallet Balance — see Wallet & Top-Ups for manual and automatic top-ups.
  • monthly_refresh entries mark your minute credits resetting on your billing anniversary, with no rollover of unused minutes from the previous cycle.
  • Adjustment and manual_adjustment entries appear when a call’s billed duration is corrected after the fact — the ledger only reflects the difference between the original and corrected charge, not a full re-bill.
  • tier_change entries appear when you change subscription plans — any minutes remaining on your old plan carry over into your new allocation, and your Wallet Balance is untouched by the switch. See Managing Your Subscription for how plan changes are billed.

​
Next Steps