Authentication Errors
| Error | Meaning | Fix |
|---|---|---|
407 Proxy Authentication Required | Credentials missing, malformed, or incorrect. | Verify credentials in the dashboard. Confirm the proxy string matches residential.roundproxies.com:5000:client-CLIENT_ID-TARGETING_PARAMS-session-SESSION_ID:PASSWORD. |
401 Unauthorized | Account recognized but request not allowed. | Check that your subscription is active and that your IP is whitelisted (if IP auth is enabled). |
Connection Errors
| Error | Meaning | Fix |
|---|---|---|
Connection Timed Out | The proxy didn’t respond in time, often due to scarce IPs in a narrow region. | Broaden targeting (drop city/state) and retry with a new session ID. |
Connection Refused / Reset | Connection rejected or dropped mid-request. | Check firewall/outbound rules and confirm you’re using port 5000. |
Targeting Errors
| Error | Meaning | Fix |
|---|---|---|
No Available IPs for Targeting | No live IPs match the requested country/state/city combination. | Drop the most specific parameter (city first, then state) or try a nearby region. |
Invalid Targeting Parameter | Parameter name or value is misspelled or unsupported. | Review the Basics page; use lowercase, dash-separated values (e.g., city-berlin). |
Session Errors
| Error | Meaning | Fix |
|---|---|---|
Session Not Sticky / IP rotates unexpectedly | Sticky session isn’t preserving the same exit IP. | Reuse the same session-SESSION_ID across requests. For longer-lived sessions, see Sessions. |
HTTP Status Errors From the Target Site
These come from the destination website, not the proxy itself.| Error | Meaning | Fix |
|---|---|---|
403 Forbidden | Site is blocking the request. | Rotate to a new session for a fresh IP and switch country/region targeting. |
429 Too Many Requests | Site is rate-limiting your requests. | Slow the request rate and rotate IPs more often. |
5xx | Server-side error on the target site. | Retry with exponential backoff; try a different exit IP via a new session. |