Errors

HTTP Status Codes

Status	Category	Description
400	Bad Request	Invalid parameter format or value
407	Proxy Auth Required	Authentication failed
500	Internal Error	Server-side failure
502	Bad Gateway	Target server unreachable
503	Service Unavailable	No proxy available for location

Authentication Errors (407)

Error Code	Description
`INVALID_CREDENTIALS`	Username or password incorrect
`SUBSCRIPTION_EXPIRED`	Subscription has expired
`TRAFFIC_EXHAUSTED`	Traffic quota exceeded
`IP_NOT_WHITELISTED`	IP not in whitelist

Proxy Errors (5xx)

Status	Error Code	Description
500	`INTERNAL_ERROR`	Server encountered an unexpected error
502	`TARGET_UNREACHABLE`	Cannot connect to target server
503	`NO_PROXY_AVAILABLE`	No proxy available for specified location

Parameter Format Errors

HTTP 400 Bad Request:

Error Code	Cause	Example
`EMPTY_CREDENTIAL`	Empty username	`:password@...`
`INVALID_CREDENTIAL_PREFIX`	Username doesn’t start with `sub_`	`user_xxx:...`
`LEADING_DASH`	Parameters start with `-`	`sub_xxx--country-US:...`
`TRAILING_DASH`	Parameters end with `-`	`sub_xxx-country-US-:...`
`CONSECUTIVE_DASH`	Contains `--`	`sub_xxx-country--US:...`
`INCOMPLETE_PAIR`	Missing parameter value	`sub_xxx-country:...`
`EMPTY_PARAM_NAME`	Empty parameter name	`sub_xxx--US:...`
`EMPTY_PARAM_VALUE`	Empty parameter value	`sub_xxx-country-:...`
`TOO_MANY_PARAMS`	More than 10 parameters	-

Parameter Value Errors

HTTP 400 Bad Request:

country

Error Code	Cause
`INVALID_COUNTRY`	Not a 2-letter code
`UNSUPPORTED_COUNTRY`	Country not available

state

Error Code	Cause
`STATE_REQUIRES_COUNTRY`	`state` used without `country`
`INVALID_STATE`	State name not recognized

city

Error Code	Cause
`CITY_REQUIRES_COUNTRY`	`city` used without `country`
`INVALID_CITY`	City name not recognized

session

Error Code	Cause
`SESSION_TOO_SHORT`	Less than 4 characters
`SESSION_TOO_LONG`	More than 20 characters
`INVALID_SESSION`	Contains non-alphanumeric characters

ttl

Error Code	Cause
`INVALID_TTL`	Non-integer value
`TTL_OUT_OF_RANGE`	Value outside 1-60

timeout

Error Code	Cause
`INVALID_TIMEOUT`	Non-integer value
`TIMEOUT_OUT_OF_RANGE`	Value outside 1-120

Troubleshooting

407 Proxy Authentication Required

Causes: INVALID_CREDENTIALS, SUBSCRIPTION_EXPIRED, TRAFFIC_EXHAUSTED, IP_NOT_WHITELISTEDSolutions:

Verify credentials in Dashboard
Check subscription status and remaining traffic
Verify whitelisted IP if using IP whitelist auth

400 Bad Request

Causes: Malformed parameter string or invalid values.Solutions:

Check parameter name typos
Verify value formats
Remove leading/trailing dashes
Ensure all parameters have values

502 Bad Gateway

Causes: TARGET_UNREACHABLE - target server cannot be reached.Solutions:

Verify target URL is correct and accessible
Increase timeout parameter
Check if target blocks proxy IPs

503 Service Unavailable

Causes: NO_PROXY_AVAILABLE - no proxy available for specified location.Solutions:

Try broader location (country instead of city)
Remove geo restrictions temporarily
Contact support

500 Internal Error

Causes: INTERNAL_ERROR - unexpected server-side failure.Solutions:

Retry the request
If persistent, contact support

Getting Started

Authentication

Proxies

Examples

Reference

HTTP Status Codes

Authentication Errors (407)

Proxy Errors (5xx)

Parameter Format Errors

Parameter Value Errors

country

state

city

session

ttl

timeout

Troubleshooting

​HTTP Status Codes

​Authentication Errors (407)

​Proxy Errors (5xx)

​Parameter Format Errors

​Parameter Value Errors

​country

​state

​city

​session

​ttl

​timeout

​Troubleshooting

HTTP Status Codes

Authentication Errors (407)

Proxy Errors (5xx)

Parameter Format Errors

Parameter Value Errors

country

state

city

session

ttl

timeout

Troubleshooting