# Error Codes

CaptchaSolv API error codes and troubleshooting guide.

All errors return: {"errorId": N, "errorCode": "...", "errorDescription": "..."}.

# Reference

Error ID	Error Code	Description	Action
0	—	Success	—
1	`ERROR_INVALID_REQUEST`	Invalid request format	Check JSON syntax and required fields
2	`ERROR_KEY_DOES_NOT_EXIST`	Invalid API key	Verify key from `/panel` in Discord
3	`ERROR_UNSUPPORTED_CAPTCHA_TYPE`	Unknown task type	Check supported types
10	`ERROR_LIMIT_EXCEEDED`	Concurrent task limit or balance exceeded	Add `"waitForSlot": true` to queue instead of failing, or wait before retrying
12	`ERROR_CAPTCHA_UNSOLVABLE`	Failed to solve	Retry (up to 3 attempts)
15	`ERROR_PROXY_BLOCKED`	Proxy/IP is hard blocked by the target (e.g. DataDome `t=bv`)	Rotate proxy and retry with a different IP
16	`ERROR_NO_SUCH_CAPCHA_ID`	Task not found	Task ID is invalid or expired

# Retry Example

Only retry on ERROR_CAPTCHA_UNSOLVABLE. Auth or validation errors won't succeed on retry.

def solve_with_retry(task, max_retries=3):
    for attempt in range(max_retries):
        response = requests.post("https://v1.captchasolv.com/solve", json={
            "clientKey": API_KEY,
            "task": task
        }).json()
        
        if response["errorId"] == 0:
            return response["solution"]
        
        if response.get("errorCode") == "ERROR_CAPTCHA_UNSOLVABLE":
            continue  # retry
        
        raise Exception(response.get("errorDescription"))
    
    raise Exception("Max retries exceeded")