Api Error Types
General•Updated 12/16/2025
Standard error (typically inside HTTP 200):
{
"errorId": 1,
"errorCode": "ERROR_CODE_HERE",
"errorDescription": "Human-readable explanation"
}
Error codes (name meaning):
- ERROR_INTERNAL - Generic internal/server error.
- ERROR_BANNED - Client IP temporarily banned for too many invalid requests (5 minute).
- ERROR_TIMEOUT - Operation timed out.
- ERROR_INVALID_KEY - API key not found/invalid.
- ERROR_KEY_EXPIRED - API key has expired.
- ERROR_USER_NOT_FOUND - No profile found for the API key's user.
- ERROR_TASK_TYPE_NOT_FOUND - Submitted task type not supported.
- ERROR_INSUFFICIENT_BALANCE - User balance is too low for the task price.
- ERROR_PENDING_LIMIT_EXCEEDED - Non-subscription user has 100 pending tasks.
- ERROR_BILLING_EXPIRED - Subscription billing/subscription expired.
- ERROR_THREAD_LIMIT_EXCEEDED - Subscription user exceeded allowed concurrent threads/active tasks.
- ERROR_TASK_CREATION_FAILED - Database insert failed when creating a task.
- ERROR_TASK_NOT_FOUND - Task id not found in database.
- ERROR_TASK_FAILED - Task stored with status
"failed". - ERROR_UNKNOWN_STATUS - Task has an unexpected/unhandled status value.
- ERROR_NO_NODES_AVAILABLE - No solver nodes are currently available to process the task.