Error Codes
All errors return a JSON body with an error field:
json
{ "error": "Human-readable error message" }| Code | Meaning | Description |
|---|---|---|
| 400 | Bad Request | Missing or invalid request parameters. |
| 401 | Unauthorized | Invalid or missing API key or session. |
| 402 | Payment Required | Credit balance depleted. Add credits to continue. |
| 403 | Forbidden | Insufficient permissions for this action. |
| 403 | Publishable Key Denied | Publishable keys can only access widget endpoints. |
| 403 | Scope Denied | This API key does not have the required scope for this endpoint. |
| 404 | Not Found | Resource does not exist. |
| 429 | Too Many Requests | Rate limit exceeded. Back off and retry. |
| 500 | Internal Server Error | Unexpected server error. Contact support. |