> For the complete documentation index, see [llms.txt](https://dinproxy.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dinproxy.gitbook.io/docs/guides/errors-and-troubleshooting.md).

# Errors & troubleshooting

What each error means and how to fix it.

## Proxy errors

When the proxy refuses a connection, the answer says why. HTTP and HTTPS clients get an HTTP status, a short text and an `X-Gateway-Error` header. SOCKS5 only shows a failed sign-in or a refused connection, so test with HTTP to see the reason.

| HTTP status                    | Reason                                                                                                                                                                                                       | What to do                                                                                                                            |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- |
| `407 AUTH_FAILED`              | Wrong or missing username or password, the proxy user was removed or suspended, or (without a password) your IP is not on your [whitelist](https://dinproxy.gitbook.io/docs/getting-started/ip-whitelist.md) | Copy the full connection username (e.g. `1024~myuser`) and password from **Tools → Users**, or add the IP under **Tools → Whitelist** |
| `429 TOO_MANY_FAILED_LOGINS`   | Too many wrong passwords from your IP or for this proxy user                                                                                                                                                 | Fix the password in your tool, then wait 10 minutes or more                                                                           |
| `403 ADDRESS_BLOCKED`          | Your IP tried 20 different wrong passwords within a day and is blocked for 24 hours                                                                                                                          | Fix the password in your tool. If you need access sooner, contact support                                                             |
| `402 QUOTA_EXHAUSTED`          | No traffic left for this port's product (7777 residential, 7779 mobile)                                                                                                                                      | Buy more traffic for that product                                                                                                     |
| `402 SUBACCOUNT_LIMIT_REACHED` | This proxy user reached its own traffic limit                                                                                                                                                                | Raise or remove the limit in **Tools → Users**                                                                                        |
| `429 TOO_MANY_CONNECTIONS`     | More than 100 connections open at the same time on your account                                                                                                                                              | Close idle connections or reuse them                                                                                                  |
| `400 REQUEST_INVALID`          | The request's `Connection` header names `Content-Length` or `Transfer-Encoding`                                                                                                                              | Remove those names from the `Connection` header                                                                                       |
| `403 TARGET_NOT_ALLOWED`       | The target is not on port 80/443 or not a public address                                                                                                                                                     | Only public websites on ports 80 and 443 can be reached                                                                               |
| `502 UPSTREAM_FAILED`          | The exit IP could not reach the site                                                                                                                                                                         | Try again; you get a new IP. With a sticky session, try a new session ID                                                              |
| `503 GATEWAY_BUSY`             | Temporary problem on our side                                                                                                                                                                                | Try again after a few seconds                                                                                                         |

## Web Unlocker errors

See the error table in the [API reference](https://dinproxy.gitbook.io/docs/guides/web-unlocker/api-reference.md#errors).

## Common questions

**My requests come from the same IP.** Your client probably reuses one HTTPS or SOCKS5 connection: it keeps one IP until it closes (plain HTTP requests change IP each time). Close connections between requests, or use different session IDs. See [rotating sessions](https://dinproxy.gitbook.io/docs/guides/residential-proxies/location-and-sessions.md#rotating-sessions-default).

**I chose a city but got another location.** Values are lower case with no spaces or accents (`losangeles`, not `Los Angeles`). The **Select location** list in **Connection setup** writes them for you.

**A sticky session changed IP early.** That happens when the IP becomes unavailable or after 60 seconds without requests. See [sticky sessions](https://dinproxy.gitbook.io/docs/guides/residential-proxies/location-and-sessions.md#sticky-sessions).

**I can't create a proxy user.** Add Credits first: proxy users can be created once your account has Credits or traffic. See [Add Credits](https://dinproxy.gitbook.io/docs/getting-started/add-credits.md).

**My connections stopped after a password reset.** A reset closes the connections that use the old password. Put the new password from **Tools → Users** in your tools.

**Can I sign in without a password, by IP address?** Yes, from up to 10 of your servers: see [IP whitelist](https://dinproxy.gitbook.io/docs/getting-started/ip-whitelist.md).

**Where do I see how much I used?** The dashboard's **Overview** shows your balances and daily usage per product.

Still stuck? Write to <support@dinproxy.com> with the time of the request, the connection username (never the password) and the error you saw.
