Authentication
Every request to /v1/check/email requires an X-API-Keyheader.
Key formats
Section titled “Key formats”| Prefix | Purpose |
|---|---|
ag_free_... |
Free-tier key (500 checks/month) |
ag_demo_... |
Demo key served to the public landing widget |
ag_live_... |
Paid-tier key (Pro / Business) |
Rotating keys
Section titled “Rotating keys”Create, list, and revoke keys from guard.ayzalai.com/settings. Up to 5 active keys per user.
Rate limits
Section titled “Rate limits”Every response includes:
X-RateLimit-Limit: 500X-RateLimit-Remaining: 498X-RateLimit-Used: 2X-RateLimit-Reset: 1793491200X-RateLimit-Reset is a Unix timestamp for the next monthly reset.
On quota exceeded:
HTTP 429{ "detail": "Monthly quota exceeded (500/500). Upgrade at https://guard.ayzalai.com"}Errors
Section titled “Errors”| Status | Meaning |
|---|---|
| 401 | Missing or invalid X-API-Key |
| 429 | Monthly quota exceeded |
| 500 | Server error — retry with backoff |