API reference

Usage

Daily usage and your remaining quota for the month.

GET/v1/usage?days=30

Returns daily counts for your workspace: single_checks, bulk_checks, cache_hits, smtp_probes (actual mail-server conversations) and unknown_checks, plus your quota. Unknown results are free, so they're counted in unknown_checks rather than the other two.

200 OK

{
  "days": 30,
  "total": { "day": "total", "single_checks": 1840, "bulk_checks": 5000, "cache_hits": 912, "smtp_probes": 4410, "unknown_checks": 167 },
  "daily": [
    { "day": "2026-10-28", "single_checks": 112, "bulk_checks": 0, "cache_hits": 40, "smtp_probes": 70, "unknown_checks": 4 }
  ],
  "quota": { "monthly": 10000, "used": 6840, "reserved": 0, "remaining": 3160 }
}