Skip to main content

​
HTTP Status Codes

StatusCategoryDescription
400Bad RequestInvalid parameter format or value
407Proxy Auth RequiredAuthentication failed

​
Authentication Errors

All authentication failures return HTTP 407:
ScenarioResponse
Invalid username407 Proxy Authentication Required
Wrong password407 Proxy Authentication Required
Expired subscription407 Proxy Authentication Required
Exhausted traffic quota407 Proxy Authentication Required
IP not whitelisted407 Proxy Authentication Required
For security reasons, the specific authentication failure cause is not disclosed.

​
Parameter Format Errors

HTTP 400 Bad Request:
Error CodeCauseExample
EMPTY_CREDENTIALEmpty username:password@...
INVALID_CREDENTIAL_PREFIXUsername doesn’t start with sub_user_xxx:...
LEADING_DASHParameters start with -sub_xxx--country-US:...
TRAILING_DASHParameters end with -sub_xxx-country-US-:...
CONSECUTIVE_DASHContains --sub_xxx-country--US:...
INCOMPLETE_PAIRMissing parameter valuesub_xxx-country:...
EMPTY_PARAM_NAMEEmpty parameter namesub_xxx--US:...
EMPTY_PARAM_VALUEEmpty parameter valuesub_xxx-country-:...
TOO_MANY_PARAMSMore than 10 parameters-

​
Parameter Value Errors

HTTP 400 Bad Request:

​
country

Error CodeCause
INVALID_COUNTRYNot a 2-letter code
UNSUPPORTED_COUNTRYCountry not available

​
state

Error CodeCause
STATE_REQUIRES_COUNTRYstate used without country
INVALID_STATEState name not recognized

​
city

Error CodeCause
CITY_REQUIRES_COUNTRYcity used without country
INVALID_CITYCity name not recognized

​
session

Error CodeCause
SESSION_TOO_SHORTLess than 4 characters
SESSION_TOO_LONGMore than 20 characters
INVALID_SESSIONContains non-alphanumeric characters

​
ttl

Error CodeCause
INVALID_TTLNon-integer value
TTL_OUT_OF_RANGEValue outside 1-60

​
timeout

Error CodeCause
INVALID_TIMEOUTNon-integer value
TIMEOUT_OUT_OF_RANGEValue outside 1-120

​
Troubleshooting

Causes: Invalid credentials, expired subscription, exhausted quota, or non-whitelisted IP.Solutions:
  1. Verify credentials in Dashboard
  2. Check subscription status and remaining traffic
  3. Verify whitelisted IP if using IP whitelist auth
Causes: Malformed parameter string or invalid values.Solutions:
  1. Check parameter name typos
  2. Verify value formats
  3. Remove leading/trailing dashes
  4. Ensure all parameters have values
Causes: Slow target server or network issues.Solutions:
  1. Increase timeout parameter
  2. Try different target URL
  3. Check if target blocks proxy IPs
Causes: No IPs available for requested location.Solutions:
  1. Try broader location (country instead of city)
  2. Contact support