Usage AnalyticsCopy Anchor Link

The Usage mode in the Claira panel shows billing-cycle token usage for the active case.

The page is titled Usage statistics. Hover the ? next to the title for a one-line summary, and select the Refresh button (the circular arrow at the top right) to reload every figure on the page.

Token balance (hero)Copy Anchor Link

• Token balance: the case's current balance. It is what is left of this month's plan tokens, plus any tokens you bought.
• Tokens per month: your plan's full monthly amount (shown next to the large balance).
• Reset note: the date your plan's tokens reset. On that date they go back to your plan's full monthly amount, and unused ones do not carry forward. See Your plan's tokens reset each month.
• Purchased tokens note: appears when the balance includes tokens you bought, and says how many. Bought tokens never expire and are never reset.
• Claim: takes your 100 free tokens for today. Each user on the case can claim once a day, up to the number of claims the case's plan allows per day. Once you have claimed, the button shows when your next claim becomes available.
• Buy tokens: opens the token pack picker. A token costs $0.10 in a pack, on every plan.

Billing-cycle month selectorCopy Anchor Link

• The center label shows the selected billing month, in the language Claira is set to.
• Use the Previous month and Next month arrows to move backward or forward when another month is available.
• The range goes from the case activation month to the latest available billing-cycle month.

Monthly summary cardsCopy Anchor Link

Four cards summarize the selected month. On a narrow panel they stack in one column, then sit two by two, and on a wide panel they share one row.

• Plan usage tokens: the plan allocation for that cycle.
• Overage tokens: tokens logged when a task runs after the balance is exhausted.
• Plan tier: the name of the highest plan the case held during that cycle, so an upgrade partway through the month shows. This matches the Plan column of the Billing Report.
• Single scans this month: how many single scans ran in the cycle. Single scans are free on every plan and do not appear on the credit charts.

Tokens by bulk type and media (stacked bar)Copy Anchor Link

The main chart, Tokens by bulk type and media (this month), breaks down token consumption by bulk type and media:

• Bulk single: bulk tasks running a single criterion per document.
• Bulk multi-code: bulk tasks running several coding criteria per document.

Hover the ? next to the chart's title for a reminder of what each bulk type counts.

Each bar is stacked by media type: Text, Image, Audio, Video. Hovering shows the exact token total per segment. On a narrow panel, a long bulk type name wraps onto a second line under its bar.

Single scans and Agent Mode messages are free on every plan, so they never appear on this chart.

The chart counts only tokens actually spent. Tokens returned by a refund are subtracted from the month the task was charged in, and tokens cleared from the balance when a case is deactivated are not usage, so neither appears on this chart, on the per-user chart, or in the month's tokens-used total.

For months whose snapshot predates the May 2026 dashboard redesign, the stacked bar is replaced by a short note. The monthly summary cards still render with the right totals.

Tokens consumed per userCopy Anchor Link

When more than one user has consumed tokens in the selected month, an additional horizontal bar chart shows token consumption per user, sorted from largest to smallest. The chart is hidden when fewer than two users have consumed tokens.

The column of names takes only the room the names need, and never more than a share of the chart, so the bars stay readable in a narrow panel. A name too long for that space is shortened with an ellipsis (…). Hover its bar to see the full name and the tokens used.

Planned vs overage tokensCopy Anchor Link

When overage tokens exist for the selected month, a small pie chart at the bottom breaks down the total into the Planned slice (consumed against your plan allocation) and the Overage slice. When there are no overages, the pie chart is hidden.

When tokens arriveCopy Anchor Link

• Monthly grant: your plan's full amount lands once per billing cycle, on the case's renewal date. Renewal dates are per case, anchored on activation.
• Free daily claim: 100 tokens, claimable once per calendar day (US Eastern), on any plan.
• Token packs: credited as soon as the payment completes.
• If you reopen a case later, Claira highlights tokens added since your previous visit.

Billing Report PDFCopy Anchor Link

You can download a Billing Report PDF from Usage mode in two scopes:

• Download {month}: the cycle you're viewing. One-page summary. Until the month has loaded, this button reads Download billing report.
• Download all-time: every cycle since the case was activated.

While a report is being prepared, the button you selected reads Preparing the download and the other button waits until it finishes. Dates and numbers in the report follow the language Claira is set to. A date range is written with "to" rather than a dash, and a figure the report does not have, such as the plan tokens in the all-time report, reads None.

Both PDFs include:

• Plan section: the plan name, a short description, and the monthly token allowance.
• Usage: tokens consumed, plan tokens, and any overage, all as token-factor counts (no dollar amounts; refer to your invoice for monetary totals).
• Tokens by category: a horizontal stacked bar showing where the tokens were spent (Bulk single, Bulk multi-code) with a colour-coded legend, using the same names as the chart in Usage mode. Single scans and Agent Mode messages are free and never appear in the breakdown. Refunds are subtracted, so the categories never add up to more than the tokens consumed.
• On every page: a line at the foot naming Claira, the report, the case, and the date you exported it, with Page 2 of 4 opposite on the right. From the second page onward, a small running header repeats the report's title, so a page that comes loose from the stack still says which case it covers.

The all-time PDF additionally has a monthly breakdown table with one row per cycle: cycle · plan · plan tokens · consumed · overage. The Plan column shows the highest tier the case held during that cycle, so a mid-month upgrade is reflected.

Billing ledgerCopy Anchor Link

At the very bottom of Usage mode, the billing ledger is a running, newest-first record of everything that affects this case's bill. Hover the info icon next to the heading for a quick summary of what it includes.

Each row is one event, with its date, a colour-coded type, and an amount. Because some events are measured in tokens and others in dollars, there are two amount columns:

• Tokens, token movements: bulk scans (debits), monthly grants, token purchases, refunds, overage, Insight charges from before Insights became free, and, when shown, free daily claims. Credits (grants, claims, purchases, refunds) appear with a + and debits with a −. Overage appears in red without a sign: it records how far past your balance a task went, rather than adding or removing tokens itself.
• Amount, dollar movements: your monthly subscription payments and the amount paid for a token purchase. When a Stripe invoice is available, the amount links to it.

The ledger covers:

• Plan upgrades and downgrades: the date each change took effect, and the tier you moved from and to.
• Monthly payments: each recurring subscription charge, on its billing date.
• Bulk scans: tokens spent creating each bulk task.
• Token purchases: one-time top-ups (tokens added and the amount paid).
• Overages: tokens used after your balance was exhausted.
• Refunds: tokens returned, for example when a bulk task fails or is cancelled. A refund reduces the tokens-used total, the tokens-by-category chart and the per-user chart for the month the original task was charged in, so those figures reflect what you actually kept.
• Insight revisions: tokens charged for an Insight before Insights became free. Insights no longer appear here.

Filtering and pagingCopy Anchor Link

• Filter by type: narrow the ledger to a single event type, or choose All events.
• Show daily token credits: free daily claims are hidden by default to keep the ledger readable, since there can be one every day. Tick this box to include them. Monthly grants are always shown.
• The ledger shows 20 events per page, newest first. Use Previous and Next to move between pages.

Single-document scans are free and never appear in the billing ledger.