Api Error Types

GeneralUpdated 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.