Errors
Error response format and API error codes.
Error responses are JSON objects with a code field. message and data are optional.
{
"code": "UNAUTHORIZED",
"message": "unauthorized",
"data": {}
}| Code | HTTP status | Description |
|---|---|---|
BAD_REQUEST | 400 | The request body, query, path parameter, or uploaded data is inv |
UNAUTHORIZED | 401 | Authentication is missing or invalid. |
WORKSPACE_LIMIT_EXCEEDED | 403 | The account or workspace has reached a plan limit. |
API_TOKEN_SCOPE_INSUFFICIENT | 403 | The API token does not include the required scope. |
NOT_FOUND | 404 | The requested resource does not exist. |
PRINT_DATA_TOO_LARGE | 413 | The raw ESC/POS payload exceeds the 1 MiB limit. |
RATE_LIMIT_EXCEEDED | 429 | The client or workspace exceeded a rate limit. |
UNKNOWN | 500 | An unexpected server error occurred. |