ERROR_IP_NOT_ALLOWEDCategory: SecurityHTTP 200

How to Fix ERROR_IP_NOT_ALLOWED in CAPTCHA Solver APIs

ERROR_IP_NOT_ALLOWED occurs when account security settings restrict API access to specific whitelisted IP addresses, and your request originated from an unlisted IP.

1. Root Causes for ERROR_IP_NOT_ALLOWED

  • IP Whitelist was configured in account security settings and the server IP changed
  • Scraper deployed to AWS Lambda, GCP Cloud Run, or dynamic serverless IP ranges
  • Home ISP assigned a fresh dynamic IP address after router restart

2. How to Resolve & Prevent This Error

  1. Navigate to 2Captcha Account Settings > Security and add your new server IP
  2. If using dynamic serverless architectures (AWS Lambda / GitHub Actions), disable IP restriction or route via a static NAT gateway
  3. Verify egress IP with curl https://api.ipify.org before adding to whitelist

3. Python Code Fix & Defensive Error Handling

# Verify current egress IP before making 2Captcha API calls
import requests

my_ip = requests.get("https://api.ipify.org").text
print(f"Server Egress IP: {my_ip}")
print("Ensure this IP is added to your 2Captcha Security Whitelist.")

4. Node.js Implementation

const ipRes = await fetch("https://api.ipify.org");
const myIp = await ipRes.text();
console.log("Current outbound IP: " + myIp + ". Verify in 2Captcha Security settings.");

5. Why 2Captcha Minimizes API Errors

2Captcha Reliability Architecture

Rank #1 Overall
  • No Slot Saturation: Tens of thousands of workers online 24/7 ensure sub-5 second task pickup
  • Zero Fee for Failures: Unsolvable CAPTCHAs are never charged to your account balance
  • Pay-As-You-Go: Deposits never expire, with a low minimum top-up of just $1.00
Get Started with 2Captcha ($0.50/1k) →

6. Frequently Asked Questions

Is IP whitelisting mandatory on 2Captcha?

No. IP whitelisting is completely optional. By default, access is permitted from any IP address with valid key authentication.

Can I whitelist IP subnets (CIDR)?

Yes. 2Captcha security settings support both individual IPv4 addresses and CIDR subnets (e.g., 198.51.100.0/24).

← Back to All Error Codes