Cost tracking
Cost is recorded per session. When a conversation ends, its usage is priced and written back onto the session record, so cost is something you read alongside the transcript rather than reconcile later.
What is measured
A session records the language-model tokens it used, split into input and output, along with a total cost in cents for the usage lines the pricing tables cover. Usage that has no price on record simply carries no cost, rather than being guessed at.
Credits
Alongside the cash figure, a session records the credits it consumed. Credits are a Saaya-side unit: your plan sets how many credits a dollar buys, and how many free credits the plan starts with. That is the number the balance on your organization is drawn down against.
What happens at the limit
Each plan declares what to do when credits run out. It either blocks further usage, or allows overage and bills for it. Which of the two applies is a property of the plan, not something set per agent or per campaign.
Aggregate view
For a period total rather than a per-conversation figure, use the session stats endpoint. It returns cost for the range you ask for, next to the same figure for the preceding period.
