Credits & Usage
Understand how VeriMails credits work and how to check your balance via API.
How credits work
- 1 credit = 1 verification â each call to the single verification endpoint uses 1 credit
- Credits are deducted only for successful requests (HTTP 200 responses)
- Requests that return 4xx or 5xx errors do not consume credits
- Credits never expire â purchased credits roll over indefinitely
Free tier
Every account starts with a free daily allowance:
- 25 verifications per day
- No credit card required
- Resets at midnight UTC
- Free credits don't accumulate â unused daily credits don't roll over
Purchasing credits
Paid plans and credit packs are available at verimails.com/pricing. Purchased credits never expire and can be used any time.
Check balance via API
GET
https://verimails.com/api/credits
Example request
bash
curl https://verimails.com/api/credits \
-H "Authorization: Bearer YOUR_API_KEY"
Response
json
{
"credits_remaining": 1842,
"credits_used_today": 158,
"daily_limit": 25
}
Response fields
| Field | Type | Description |
|---|---|---|
credits_remaining | integer | Total credits available in your account |
credits_used_today | integer | Credits consumed today (resets midnight UTC) |
daily_limit | integer | Free daily limit for your plan (25 on free tier) |
On paid plans,
daily_limit reflects your plan's daily allocation. Purchased credit packs contribute to credits_remaining and are used after daily allotment is exhausted.