Solverify

Solverify API Error Codes

General•Updated 5/4/2026

This page explains Solverify API error codes, validation limits, and task limit errors. Use it when handling failed createTask, getTaskResult, getBalance, profile, or activeTasks responses.

Standard Customer API Error

Most customer-facing validation and business errors are returned as JSON with HTTP 200:

{
  "errorId": 1,
  "errorCode": "ERROR_CODE_HERE",
  "errorDescription": "Human-readable explanation"
}

Some internal/node routes use HTTP status codes such as 400, 401, 404, 409, or 500.

Error Codes

  • ERROR_INTERNAL - Generic internal/server error.
  • ERROR_INVALID_REQUEST - Request body is invalid JSON or missing required top-level fields.
  • ERROR_INVALID_TASK - Task object is malformed or required task parameters are missing/invalid.
  • ERROR_UNSUPPORTED_TASK - Task type is not currently priced/supported.
  • ERROR_INVALID_KEY - API key is not found or invalid.
  • ERROR_KEY_EXPIRED - API key has expired.
  • ERROR_USER_NOT_FOUND - No profile found for the API key's user.
  • ERROR_INSUFFICIENT_BALANCE - User balance is too low for the task price.
  • ERROR_PENDING_LIMIT_EXCEEDED - Pay-per-solve user exceeded the active task limit.
  • ERROR_BILLING_EXPIRED - Thread/subscription billing period has expired.
  • ERROR_THREAD_LIMIT_EXCEEDED - Thread/subscription user exceeded allowed active tasks.
  • ERROR_NO_CAPACITY - No solver capacity is currently available for the task type.
  • ERROR_TASK_CREATION_FAILED - Task could not be created.
  • ERROR_TASK_NOT_FOUND - Task does not exist or does not belong to the API key.
  • ERROR_TASK_FAILED - Task finished with status failed; errorDescription contains the failure reason when available.
  • ERROR_UNKNOWN_STATUS - Task has an unexpected internal status.
  • ERROR_IP_BANNED - Client IP was temporarily banned after repeated invalid API key attempts.
  • ERROR_REQUEST_TEMPORARILY_BANNED - Account request access is temporarily blocked due to repeated request failures.
  • ERROR_TIMEOUT - Operation timed out.