Reference for all API error codes and how to handle them.
HTTP Status Codes
| Code | Meaning |
|---|
| 200 | Success |
| 400 | Bad Request - Invalid parameters |
| 401 | Unauthorized - Invalid API key |
| 403 | Forbidden - Insufficient permissions |
| 404 | Not Found - Endpoint doesn't exist |
| 429 | Too Many Requests - Rate limited |
| 500 | Server Error - Try again later |
Error Response Format
{
"error": "invalid_email",
"message": "The email address format is invalid",
"code": "E1001",
"details": {
"field": "email",
"value": "not-an-email"
}
}
Common Error Codes
| Code | Error | Solution |
|---|
| E1001 | invalid_email | Check email format |
| E1002 | missing_email | Include email in request |
| E2001 | insufficient_credits | Add more credits |
| E2002 | quota_exceeded | Upgrade your plan |
| E3001 | file_too_large | Reduce file size |