Skip to content

docs(credit-usage): explain credits-used vs available-balance discrepancy #1509

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
george-dilthey wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs(credit-usage): explain credits-used vs available-balance discrepancy #1509

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions docs/credit-usage.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -192,6 +192,14 @@ Alternatively, turn auto-run **off** entirely before editing (`⛭` → toggle *

See [Auto-run](auto-run.md) for full details on **Keep existing results** and how the auto-run mode affects which cells run.

### Credits used total doesn't match my available balance

The **Credits used** figure shown on each tab (Workbooks, Integrations, Signals, MCP, API) reflects credit spend attributed to that specific category. Your **available balance** — the "X credits available" indicator in the top navigation bar and on the Total Balance tab — is drawn from your workspace's credit ledger, which tracks all credit movements: tab-level spend, refunds, and any account credits applied to your balance.

Because the available balance accounts for all credit movements while each tab's Credits used reflects only spend in that category, subtracting Credits used from your yearly allotment will not always equal your available balance exactly. A small gap between the two figures is expected and does not indicate an error — your available balance is the accurate reflection of credits remaining in your account.

To get the closest view of your total credit spend for a period, add up the Credits used totals across all tabs (Workbooks, Integrations, Signals, MCP, and API) for the same time range. If that sum still doesn't reconcile exactly with your allotment minus your available balance, the remaining difference is typically accounted for by refunds or account credits applied to your workspace outside of the per-tab spend tracking.

### Requesting a goodwill credit refund

If credits were accidentally consumed — for example, from a misconfigured scheduled run or an unintended large batch — you can contact [Clay support](https://app.clay.com) to request a one-time goodwill credit refund. When submitting a request, include:
Expand Down