Skip to main content

Error Response Format

When an error occurs, the response includes:

Authentication Errors

Validation Errors

Proxy Errors

Rate Limit Errors

Task Errors

Service Errors

Handling Errors

Retryable Errors

These errors are temporary and can be retried with backoff:
  • ERROR_SERVICE_UNAVALIABLE
  • ERROR_DATABASE_UNAVAILABLE
  • ERROR_DATABASE_BALANCE
  • ERROR_FINGERPRINT_UNAVAILABLE
  • ERROR_PROXY_CONNECTION
  • ERROR_THREAD_THRESHOLD_EXCEEDED
  • ERROR_SOLVE_TIMEOUT
  • ERROR_PROCESSING_IMAGE

Non-Retryable Errors

These errors require fixing the request:
  • All validation errors (ERROR_MISSING_*, ERROR_INVALID_*)
  • ERROR_KEY_DOES_NOT_EXIST
  • ERROR_ACCOUNT_SUSPENDED
  • ERROR_ZERO_BALANCE
  • ERROR_TASK_NOT_SUPPORTED
  • ERROR_TEMPLATE_NOT_FOUND

Example Error Handling