Usage and statements

Two console pages, both under Usage & billing, show what your agents use and what you are charged:

Usage: raw quantities from the models and speech services your agents call, with no prices.
Billing: what you pay Caplo, by day, with the month’s statement.

Both need a role that can view financial data: Owner, Admin, Billing or Auditor. Days and months are UTC.

Usage page

The Usage page answers “how much did our agents use, and where?”.

Filters at the top apply to everything on the page:

Filter	Options
Source	Production (the default), Live tests, Evals, Background, Authoring or All sources.
Keys	All keys, Caplo-managed or Your keys.
Agent and Channel	One agent or channel, or all.
Dates	Last 7 or 30 days, or any range within the last 400 days.

Tiles show the totals for the range: Language model tokens, Speech to text (audio minutes), Text to speech (characters), Voice minutes and Conversations. Voice minutes and conversations are not paid with a provider key, so they show no value when you filter by keys.

Usage by channel shows how language model tokens or voice minutes split across your channels.

Language models charts tokens over time and lists them by Model, Provider, Agent or Channel, with Input, Cached input, Output, Audio (realtime models) and Requests columns.

Voice charts Speech to text, Text to speech or Voice minutes, grouped the same way.

Usage on your own keys is included on this page. Those providers bill you, not Caplo.

If a provider has not reported full usage for some requests yet, a note under the table says how many; their known quantities are included. Quantities update as providers report them, and each request counts once at its latest report.

Billing page

The Billing page answers “what will Caplo charge us?”.

Filters: Charges (All charges, Voice, Text or Language models), Agent, Channel and Billing dates (This month, Last month, Last 30 days or a custom range).

Tiles:

Tile	What it shows
Estimated amount due	The statement for the month that contains the end of your date range: that month’s charges to date, after the included allowance. It always covers the whole workspace, whatever the filters.
Platform	Platform fees in the range, with the number of voice minutes and AI replies.
AI usage	Caplo-managed models and speech, at list price plus your plan’s markup.
Included allowance	How much of the month’s allowance is used, and how much is left.

Charges over time shows daily or weekly charges by type. Charges by splits them by channel, agent or charge type. Charge breakdown lists every charge in the range grouped by Charge, Model, Provider, Agent or Channel, with quantity, rate, amount and share.

Notes under the breakdown explain two cases:

How many requests used your own keys. Only the platform fee for those conversations appears.
Caplo-managed requests that used a meter without a list price yet. They are charged for their priced part only.

Daily charges and the monthly statement

Each charge belongs to the UTC day the usage happened and is priced with the price plan in effect at that time. The monthly statement adds up the calendar month’s charges and subtracts the allowance. It is an estimate until the month closes.

To follow a month as it goes, choose This month. To review a finished month, choose Last month. Settings then Billing & limits shows the same month-to-date summary: Estimated amount due, Charges to date and Included each month.

Export

Both pages have Export CSV:

Usage exports exact quantities per UTC day, service, provider and model, with request counts and any usage Caplo cannot classify yet.
Billing exports every charge per UTC day, with its charge type, provider, model, agent, channel, quantity, unit, amount in USD and whether a price plan rated it.

Consistent numbers

Each page reads all its charts and tables from one snapshot, shown at the bottom of the page with its time. Select Refresh to load a newer one. Exports use the same snapshot as the page, so a CSV matches what you see.