# Balance and usage

## GET /v1/account

Your balance, monthly allowance and per-check costs. **Free.**

```bash
curl https://veqen-app.com/v1/account -H "Authorization: Bearer $VEQEN_API_KEY"
```

```json
{
  "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. |

```bash
curl "https://veqen-app.com/v1/usage?days=7" -H "Authorization: Bearer $VEQEN_API_KEY"
```

```json
{
  "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.