Credits are the currency of email validation in Allegrow. Every validation — whether it comes through the API, a CSV upload, or your team working in the app — draws from one shared workspace balance. Get Credit Balance reports that balance in real time, straight from the same store that meters your validations, so what you see is exactly what the next validation will be charged against.
Depending on your plan, your balance is made up of up to three allowance types:
- Monthly allowance — a recurring number of validations included with your plan, resetting on the 1st of each calendar month (UTC). This is what most workspaces run on.
- Additional credits — credits granted as a standalone balance, for example a purchased credit pack. They never expire, and they're consumed before your monthly allowance.
- Daily allowance — a balance that replenishes each day, included with some plans.
The response's planType field tells you at a glance how your workspace is provisioned: monthly, unlimited, prepaid (additional credits only), or none. Every key is always present — null simply means that field doesn't apply to your plan.
Unlimited plans include unlimited email verification — no credit limits via integration or CSV — with API access capped at 1,000,000 requests per month, as stated on our plans page. For these plans the endpoint reports usage rather than a balance: limit, remaining, and creditsRemaining are null, and monthlyAllowance.used tracks the current month's consumption.
Two practical notes for integrators:
- Checking your balance is free — the endpoint never consumes credits — and it's subject to the same per-key rate limit as your other API calls.
- Because credits are shared workspace-wide,
usedreflects your team's total consumption, not just what your API key has spent. If your numbers move without API traffic, someone is validating in the app or uploading a CSV.
When credits run out, validation calls return 402 — poll Get Credit Balance and alert on creditsRemaining before you get there.