> ## Documentation Index
> Fetch the complete documentation index at: https://docs.threetone.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Credits and usage

> Interpret saved subscription balances, distinguish usage totals from period measurements, and check current billing information.

Credit information helps you understand the balance recorded for your workspace. Read the fields together with subscription status and billing-period dates rather than treating one number as a complete usage report.

## Read the subscription information

Use the dashboard or [Get user subscription info](/api-reference/get-user-subscription-info) to inspect the saved information.

| Field | How to interpret it |
| - | - |
| `tier`, `plan_name` | The saved plan identity and display name. |
| `status` | The subscription state reported by the API. |
| `credits_balance` | The recorded wallet balance. |
| `credits_limit` | The included-credit field returned for the subscription. Confirm the effective plan policy before relying on it. |
| `credits_used` | A stored usage total. It is not established as current-month consumption. |
| Billing-period timestamps | The period associated with the saved subscription. |
| `cancel_at_period_end` | Whether cancellation is scheduled at the period boundary. |

## Review a balance change

Check the active workspace, the subscription status, and whether a payment or subscription update has completed. Compare the current response with a previously saved response for the same workspace. Keep timestamps and identifiers when asking support to investigate.

The detailed usage dashboard is not implemented in the documented source. Saved subscription information does not provide a complete breakdown by agent, model, API key, or current billing month.

## Renewals, rollover, and additional usage

The release policy must define how included usage is allocated, when it expires, and how a change of plan affects it. The [planned pricing](/overview/administration/billing/pricing) and [pay-as-you-go](/overview/administration/pay-as-you-go) pages describe the intended direction. They are not evidence that the current wallet enforces every planned rule.

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Does credits_used show this month's usage?" id="faq-usage-period">Not necessarily. The documented projection reads a wallet usage total. Do not label it current-month usage without a period-specific report.</Accordion>
  <Accordion title="Does zero overage mean additional usage is free?" id="faq-zero-overage">No. The documented overage field is not a verified metered-charge calculation. Consult the effective pricing and checkout terms for charges.</Accordion>
  <Accordion title="How many free credits do I receive?" id="faq-free-allocation">The current source contains inconsistent free-allocation values. Confirm your actual balance and the effective offer in the dashboard; this guide does not promise a fixed free allotment.</Accordion>
  <Accordion title="Can credits be converted into guaranteed call minutes?" id="faq-credit-minutes">A recorded credit balance alone does not define that conversion. Use the effective plan's allowances and measurement policy; model and carrier charges can be separate.</Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.