Error Codes
The API uses standard HTTP status codes.
| Code | Meaning | Description |
|---|---|---|
200 | OK | Request successful. |
202 | Accepted | Async request queued successfully. |
400 | Bad Request | Missing email or invalid parameters. |
401 | Unauthorized | Missing API key. |
402 | Payment Required | Insufficient credits. Please top up. |
403 | Forbidden | Invalid API key or permission denied. |
429 | Too Many Requests | Rate limit exceeded. |
500 | Server Error | Internal system error. |
Rate Limits
Rate limits are only enforced on the Free Plan:
- Free: 1 request per 5 seconds.
- Pay As You Go: Unlimited.
- Pro: Unlimited.
- Enterprise: Unlimited.
If you exceed the Free Plan limit, you will receive a 429 response with the following format:
{
"error": "Rate limit exceeded, try again after 5 seconds, your plan is \"free\"",
"retryAfter": 5,
"plan": "free"
}
The retryAfter field indicates how many seconds you should wait before retrying. The plan field shows your current subscription plan.