Errors, quotas & limits

Error shape

Every error is JSON:

{ "error": "Enrichment limit reached (150/month)", "requestId": "req_…" }

Include requestId when reporting an issue — it links directly to our logs.

Status codes

• 400 — malformed input (missing fields, bad cursor)
• 401 — missing, malformed, or revoked API key
• 402 — spend budget exhausted (daily AI budget), or subscription required for key creation
• 403 — no active subscription on this workspace
• 404 — resource not in your workspace
• 429 — plan quota exhausted (e.g. monthly enrichments)
• 5xx — our fault; retry with backoff (the SDK does automatically)

Quotas by plan

• Starter ($99/mo) — 150 signals/mo, 50 enrichments/mo, $0.50/day AI budget
• Professional ($199/mo) — 400 signals/mo, 150 enrichments/mo, $1.00/day AI budget
• Power ($399/mo) — unlimited signals & enrichments, $5.00/day AI budget

Monthly quotas reset on the 1st (UTC); daily budgets reset at midnight UTC. Live usage is always visible in Settings → Usage.