Error Handling - Roundproxies Docus

When using Roundproxies residential proxies, you may run into errors from the proxy network or the target site. The tables below summarize the most common ones, what they mean, and how to fix them.

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.

Still stuck?

Reach out at team@roundproxies.com or visit the Help Center.