Documentation Index
Fetch the complete documentation index at: https://docs.roundproxies.com/llms.txt
Use this file to discover all available pages before exploring further.
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.