Errors

HTTP Status Codes

Status	Category	Description
400	Bad Request	Invalid parameter format or value
403	Forbidden	Destination is blocked at the gateway
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

Blocked Destinations (403)

A small set of destinations is refused at the gateway. The request never reaches the target and you get a plain text response:

HTTP/1.1 403 Forbidden
Content-Type: text/plain

Domain blocked.

Blocking applies to individual hostnames as well as whole domain suffixes, so example.gov and any host under it are refused by the same rule. If you think a destination is blocked by mistake, send us the exact hostname and we will review it.

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)

Blocked Destinations (403)

Proxy Errors (5xx)

Parameter Format Errors

Parameter Value Errors

country

state

city

session

ttl

timeout

Troubleshooting

​HTTP Status Codes

​Authentication Errors (407)

​Blocked Destinations (403)

​Proxy Errors (5xx)

​Parameter Format Errors

​Parameter Value Errors

​country

​state

​city

​session

​ttl

​timeout

​Troubleshooting

HTTP Status Codes

Authentication Errors (407)

Blocked Destinations (403)

Proxy Errors (5xx)

Parameter Format Errors

Parameter Value Errors

country

state

city

session

ttl

timeout

Troubleshooting