What Your Proxy Error Code Is Telling You
In plain English: when a request through a proxy fails, you usually get a status code, a short number that says what went wrong. Some codes point to your own proxy setup, such as your login details or the connection. Others come from the website you're visiting, such as a permissions problem or a rate limit. Knowing which side the problem is on saves a lot of guesswork.
Below are the codes you're most likely to see as a beginner using a proxy, and a simple fix for each. Want a live check? Our proxy checker tells you whether a proxy accepts your login and shows the exit IP, the address websites see.
Written and kept up to date by the people who run Budget Proxies. If a step no longer matches what you see on your screen, let us know through the contact page.
What this guide walks you through
- Is it my setup? Errors from the proxy side
- Or is it the website? Errors the site sends back
- All the common codes in one table
- Fixing errors in a sensible order
- Next steps once things work
Is it my setup? Errors from the proxy side
Your login didn't work (407 Proxy Authentication Required)
The proxy didn't accept your details. Look again at the username and password; one wrong character is enough to cause it. If you use IP whitelisting (approving your own address in advance) instead, the IP of the device you're connecting from has to be on that list. This is the error people run into most often during their first setup.
Nothing answered at all (connection refused or timed out)
Your program couldn't reach the gateway at all. Go through three things: the host and port are typed correctly, the protocol you chose (HTTP/HTTPS or SOCKS5) is the one that endpoint expects, and no firewall on your own computer is stopping the connection.
Or is it the website? Errors the site sends back
The site turned you away (403 Forbidden)
The website refused the request. It usually comes down to how far the site trusts the IP, or to its own rules. Match the type to the site, such as a more trusted residential IP from a home connection for protected sites, and make sure what you're doing is allowed by its terms.
You're going too fast (429 Too Many Requests)
You've hit a rate limit, the cap a site puts on how many requests it accepts in a given time. Slow down, add random pauses, run fewer requests at once and let rotation share the work between IPs. It's the error you'll meet most as a project grows.
A temporary hiccup somewhere (502 / 503 / 504)
These three (bad gateway, service unavailable, gateway timeout) usually point to short-lived trouble at the website or on the route to it. Retry with exponential backoff, which means waiting a little longer before each new try; if it keeps happening, the website may be down.
All the common codes in one table
Keep this table handy: each code, what it means, the usual reason and your first move.
| Code | In plain English | Usual reason | Try this first |
|---|---|---|---|
| 407 | The proxy wants a valid login | Wrong login, or your IP isn't whitelisted | Re-check username/password or the whitelist |
| 403 | The site turned you away | A distrusted IP, or the site's rules | Use a more trusted pool; read the terms |
| 429 | You're going too fast | You hit the site's request limit | Slow down, rotate, send fewer at once |
| 502/504 | Something along the way failed | Temporary problem at the site or upstream | Wait, then retry, waiting longer each time |
| Timeout | Nothing came back | Typo in host/port, or no connection | Re-check the address, port and protocol |
Fixing errors in a sensible order
Work from your end towards the website; in that order you'll find the fault sooner:
- Test the proxy on its own with the proxy checker. That rules login and connection problems (407, timeouts) in or out.
- Check your pace if you see 429: fewer requests, fewer at once, rotation on.
- Check the IP type when a protected site answers with 403, and move to residential or premium, our curated pool.
- Retry 5xx errors (server errors whose code starts with a 5) with backoff before assuming something is really broken.
Whatever the code, stay with public data and within each site's terms of service; a proxy can't promise you'll get in.
Next steps once things work
With the errors fixed, here's a reminder of what's in every plan: you can connect over HTTP/HTTPS or SOCKS5, sign in with a username and password or an IP whitelist, and pick from 55+ countries, and the service runs at 99.9% uptime. When you're ready, see the pricing page or buy now. Still seeing 403 and 429 errors? Why proxies get blocked explains the usual causes.
Questions beginners ask
Not sure what to buy? Start at step 1
Here are our four types, from the lowest price per GB upwards. Try a small amount of the first one that could work for your project, and only move up a step if a quick test lets you down.
Sites without bot protection, big batches of public pages, automation and SEO tools
Protected sites, ad checks, market research and seeing what one place really sees
Apps and platforms built for phones, plus testing your own mobile app
Well-guarded sites, where a better success rate is worth the higher price
Small first order? Datacenter from $2.49/GB · billed on the data you actually move · ready straight away · 30 days to use it · no traffic logs.
What to read next
What Are Proxies? A Starting Point for Beginners
A proxy passes your traffic on, so websites see its address rather than yours. How it works, the types you ca…
Read the guide →What Are Datacenter Proxies? The Low-Cost Place to Start
Datacenter proxies use addresses from server companies, so they're quick and low-cost. How they work, where t…
Read the guide →What Are Residential Proxies? Home Addresses, Explained
A residential proxy sends your requests through a real home connection, so sites see a local visitor. How it …
Read the guide →Datacenter vs Residential Proxies: Which Should a Beginner Buy?
Datacenter is quick and low-cost; residential is trusted more. A plain comparison of speed, price and success…
Read the guide →Mobile vs Residential Proxies: Do You Really Need Mobile?
Mobile proxies use phone-network IPs; residential ones use home broadband. How trust, cost and uses differ, a…
Read the guide →Proxy or VPN? The Difference, and Which One You Need
Already have a VPN app? How a proxy differs, what each one is good for, and why a proxy suits jobs like check…
Read the guide →Got a particular job in mind?
Ready to try your first proxy?
Choose from 55+ countries, pay from $2.49/GB for only the data you use, and get your login details straight away. If a step trips you up, human support is there 24/7.
