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.