Error Codes

Response Errors

Server is busy processing solve requests.

{
    "errorId": 1008,
    "error": "Server too busy. Try again later."
}

Missing required parameters.

{
    "errorId": 2001,
    "error": "Missing required request parameters: [...]"
}

Unexpected Error.

{
    "errorId": 2003,
    "error": "..."
}

Rate limit exceeded.

{
    "errorId": 1006,
    "error": "..."
}

Your query parameters are invalid, or something went wrong during the captcha solving process. Please check if you are sending valid parameters, this error can occur if the Recaptcha site key is not V2 or is invalid.

{
    "errorId": 1007,
    "error": "Server Error"
}

Invalid Recaptcha site key.

{
    "errorId": 2002,
    "error": "Invalid siteKey"
}

Invalid Recaptcha site URL.

{
    "errorId": 2002,
    "error": "Invalid site URL"
}

Invalid query data. Please check if you are sending valid parameters.

{
    "errorId": 2002,
    "error": "Invalid query data"
}

Invalid API Key

{
    "errorId": 1001,
    "error": "API key blocked: API key not found"
}

Unauthorized / Missing API Key.

{
    "errorId": 1005,
    "error": "Unauthorized/API Key Missing"
}

Empty balance / Not enough balance.

{
    "errorId": 1002,
    "error": "API key blocked: API key balance is empty"
}

Internal Server Error.

{
    "errorId": 1007,
    "error": "..."
}

API Key Temp Blocked.

If you send too many invalid requests you might get blocked for a minute.

{
    "errorId": 1004,
    "error": "API key blocked: Temporarily banned for 1 minute(s)."
}

API Key Blocked.

{
    "errorId": 1003,
    "error": "API key blocked: ...."
}