Error Codes
Reference guide for HTTP statuses and Map Zena error codes returned by the API.
Error Codes
Errors return JSON with a stable structure and explicit code fields for reliable automation.
Error format
json
{
"status": "error",
"error": {
"code": "invalid_request",
"message": "Missing required parameter: q"
}
}
Common errors
| HTTP | Code | Meaning |
|---|---|---|
| 400 | invalid_request | Malformed or missing parameters. |
| 401 | unauthorized | API key missing or invalid. |
| 402 | insufficient_credit | Registered key has no remaining account credit. |
| 404 | not_found | No matching record for request. |
| 429 | anonymous_quota_exceeded | Anonymous free quota exhausted for the day. |
| 429 | rate_limit_exceeded | Burst limit exceeded for current request window. |
| 500 | internal_error | Unexpected server-side failure. |
| 503 | service_unavailable | Maintenance or temporary outage. |
Troubleshooting
- Verify required parameters and type formats.
- Check free quota status and rate-limit headers.
- If using a key, verify your account credit balance.
- Retry 5xx responses with exponential backoff.
- Open a support request via Contact for persistent failures.