Errors
The Public API uses standard HTTP status codes and returns structured JSON error objects.
Error format
All error responses follow this structure:
json
{
"error": {
"code": "INVALID_API_KEY",
"message": "Invalid API key. Please check your API key and try again.",
"status": 401
}
}Error codes
| Code | Status | Description |
|---|---|---|
UNAUTHORIZED | 401 | Missing or malformed Authorization header. |
INVALID_API_KEY | 401 | API key not found in the system. |
API_KEY_REVOKED | 401 | Key has been revoked from the dashboard. |
API_KEY_EXPIRED | 401 | Key has passed its expiration date. |
ACCOUNT_SUSPENDED | 403 | Account has been suspended or cancelled. |
PLAN_REQUIRED | 403 | No active plan associated with account. |
FORBIDDEN_ENDPOINT | 403 | Your plan does not grant access to this endpoint. |
RATE_LIMIT_EXCEEDED | 429 | Too many requests. Check Retry-After header. |
DAILY_QUOTA_EXCEEDED | 429 | Daily request limit reached. Resets at midnight UTC. |
MONTHLY_QUOTA_EXCEEDED | 429 | Monthly request limit reached. Upgrade your plan. |
RESOURCE_NOT_FOUND | 404 | Requested resource does not exist. |
VALIDATION_ERROR | 400 | Invalid request parameters. |
INTERNAL_SERVER_ERROR | 500 | Unexpected server error. Please try again. |
Troubleshooting
💡
Getting 401? Make sure your header is exactly Authorization: Bearer sk_live_xxx — no extra spaces, no quotes around the key.
⚠️
Getting 403 FORBIDDEN_ENDPOINT? Your plan may not include access to this endpoint. Check the Rate Limits & Quota page for plan permissions, or upgrade from the Developer Dashboard.