Balance and usage
Read your credit balance and daily usage from code. Both endpoints are free.
GET /v1/account
Your balance, monthly allowance and per-check costs. Free.
curl https://veqen-app.com/v1/account -H "Authorization: Bearer $VEQEN_API_KEY"
{
"email": "you@company.com",
"balance": { "free": 640, "paid": 50000, "total": 50640 },
"free_monthly_credits": 1000,
"free_resets_at": "2026-11-01T00:00:00Z",
"costs": { "email": 1, "ip": 1, "phone": 1, "domain": 1, "signup": 3, "mailbox": 5 },
"rate_limit_per_second": 50
}
GET /v1/usage
Credits and calls per day. Free.
| Query parameter | Default | Description |
|---|---|---|
days |
30 | How many days back, 1 to 365. |
curl "https://veqen-app.com/v1/usage?days=7" -H "Authorization: Bearer $VEQEN_API_KEY"
{
"days": [
{ "date": "2026-10-19", "credits": 412, "calls": 260, "by_check": { "email": 180, "signup": 76, "ip": 4 } },
{ "date": "2026-10-20", "credits": 128, "calls": 95, "by_check": { "email": 70, "signup": 15, "phone": 10 } }
],
"total_credits": 540,
"total_calls": 355
}
Days with no usage are left out. Dates are in UTC.