Common Error Codes
Quick reference for all error codes returned by the SilentShield API.
| Status | Error | Description | Solution |
|---|---|---|---|
400 | invalid_request | Invalid request body or missing required fields. | Check the request format matches the API documentation. |
401 | missing credentials | API key is missing from the request. | Add the X-Api-Key header to your request. |
403 | ip_not_whitelisted | Client IP is not in the security policy whitelist. | Add the IP to the whitelist in Dashboard → Security Policy. |
403 | ip_blacklisted | Client IP is in the security policy blacklist. | Remove the IP from the blacklist in Dashboard → Security Policy. |
403 | domain_mismatch | The request's Origin/Referer domain doesn't match the API key's domain. | Update the domain in Dashboard → API Keys → Edit. |
403 | referer_not_allowed | The referer domain is not in the allowed referers list. | Add the domain to Allowed Referers in Security Policy. |
429 | quota_exceeded | Monthly request quota has been exceeded. | Upgrade your plan or wait until the quota resets. |
429 | ip_rate_limited | Per-IP rate limit has been reached. | Wait 60 seconds. The Retry-After header indicates when to retry. |
429 | domain_not_verified_limit | Unverified domain has exceeded the 100 requests/day test mode limit. | Verify your domain to unlock your full quota. |