Skip to main content

​
HTTP Status Codes

StatusCategoryDescription
400Bad RequestInvalid parameter format or value
407Proxy Auth RequiredAuthentication failed
500Internal ErrorServer-side failure
502Bad GatewayTarget server unreachable
503Service UnavailableNo proxy available for location

​
Authentication Errors (407)

Error CodeDescription
INVALID_CREDENTIALSUsername or password incorrect
SUBSCRIPTION_EXPIREDSubscription has expired
TRAFFIC_EXHAUSTEDTraffic quota exceeded
IP_NOT_WHITELISTEDIP not in whitelist

​
Proxy Errors (5xx)

StatusError CodeDescription
500INTERNAL_ERRORServer encountered an unexpected error
502TARGET_UNREACHABLECannot connect to target server
503NO_PROXY_AVAILABLENo proxy available for specified location

​
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, SUBSCRIPTION_EXPIRED, TRAFFIC_EXHAUSTED, IP_NOT_WHITELISTEDSolutions:
  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: TARGET_UNREACHABLE - target server cannot be reached.Solutions:
  1. Verify target URL is correct and accessible
  2. Increase timeout parameter
  3. Check if target blocks proxy IPs
Causes: NO_PROXY_AVAILABLE - no proxy available for specified location.Solutions:
  1. Try broader location (country instead of city)
  2. Remove geo restrictions temporarily
  3. Contact support
Causes: INTERNAL_ERROR - unexpected server-side failure.Solutions:
  1. Retry the request
  2. If persistent, contact support