> ## Documentation Index > Fetch the complete documentation index at: https://docs.voxworks.ai/llms.txt > Use this file to discover all available pages before exploring further. # Usage History > How to read your Wallet Usage and Minute Usage ledgers, filter by billing period, and export usage as CSV. ## 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](/billing/how-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: | Entry type | Badge | What it means | | -------------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Usage** | blue | A call charged to your wallet. If the entry is tied to a specific call, the description reads "Call - `{contact name}`" as a link that opens that call's record. | | **Topup** | green | A manual or automatic wallet top-up. | | **Overage** | grey | Usage beyond your plan's included minutes, charged to the wallet at your plan's overage rate. | | **Refund** | green | Money credited back to your wallet, including the refunded portion of a corrected call duration. | | **Adjustment** | grey | A correction to a previously billed amount — for example, the extra charge for a call whose duration increased after billing. | | **Initial** | grey | The opening balance entry created when your account's wallet was first set up. | 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. | Action type | Badge | What it means | | ----------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------ | | **call\_usage** | Usage (blue) | Minutes deducted for a call. If linked to a call, the description reads "Call - `{contact name}`" as a link that opens that call's record. | | **initial\_allocation** | Allocation (green) | The initial minute allocation made when your Trial or plan started. | | **monthly\_refresh** | Refresh (green) | Your plan's included minutes resetting to their full allocation. | | **tier\_change** | Tier Change (grey) | A change in subscription tier; the description shows the old and new tier slugs, e.g. "Tier change: starter → growth". | | **manual\_adjustment** | Adjustment (grey) | A manual correction to your minute balance. | 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](/billing/how-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](/billing/wallet) 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](/billing/subscription) for how plan changes are billed. *** ## Next Steps * [How Call Billing Works](/billing/how-billing-works) — the 60-second minimum, the credits-before-wallet order, and adjustment rules behind these ledger entries. * [Wallet & Top-Ups](/billing/wallet) — what the wallet pays for and how to top it up manually or automatically. * [Plans, Tiers & Feature Gates](/billing/plans) — included minutes and overage rates by tier. * [Calls: History](/calls/history) — the full call log that Usage entries link back to.