Quality & errors · glossary

Gateway error codes

Gateway error codes are HTTP status codes generated by the proxy gateway rather than by the destination website, signalling that a request could not be forwarded: missing or wrong credentials, an invalid targeting parameter, an empty balance, a blocked destination, or no exit available for the requested location. Telling them apart from destination errors is the first step of any troubleshooting, because the fix is on your side of the gateway.

2 min read Also called proxy errors, 502 from proxy, 407 407 407 Updated

Codes at ProxShift#

StatusCodeMeaningWhat to change
407invalid_credentialsUsername or password rejectedCheck the credential pair, or whitelist the source IP
400invalid_parameterA username parameter is unknown or malformedFix the key or value (-cc-, -city-, -ttl-…)
402insufficient_balanceNo traffic or balance leftTop up
403blocked_destinationPort or destination not allowedPort 25, UDP and IPv6-only targets are refused
502no_exit_available / exit_failedNo exit matches, or the exit failed before the targetWiden the location; retry once
504target_timeoutThe destination did not answer in timeRetry; check the target itself

Gateway or destination?#

Gateway errors carry a Proxy-Agent style body from the gateway; destination errors carry the website's own page. A 403 with the target's branding is a block by the site; a 403 blocked_destination is the gateway refusing the port.

How it works at ProxShift#

ProxShift never returns 429 from the gateway; rate limits only ever come from the destination. Every code above is documented with its body on the errors page.

Ready when you are

See it on a real request.

Create an account, top up $20 and run the quickstart against your own target. Traffic you buy never expires.