Proxy Errors Troubleshooting

Prefer an enterprise-grade guide? Learn more about Oculus Proxies Proxy Errors Troubleshooting.

Toolip Requires Host:Port – IP:Port is Not Supported

Toolip does not support direct IP connections. All proxies must be configured using a hostname instead of an IP address. Using IP:Port may result in connection errors.

Correct Format:

proxy.toolip.io:8080

Only Search Engine ISP uses IP:Port connection

Incorrect Format:

192.168.1.1:8080

If your provider supplies only an IP, check if they offer a corresponding hostname—Toolip requires it for proper functionality.

Why Hostnames?

Toolip leverages DNS-based proxy routing for improved reliability, security, and load balancing. This ensures seamless connectivity and better performance across proxy networks.

HTTP Header Fields

When making HTTP or HTTPS requests, Toolip provides detailed error messages in the response headers to help troubleshoot issues.

Field	Description	Examples
`HTTP Error`	The protocol error numbers	`404` or `502`
`x-tlp-err-code`	toolip module and error code number	`client_10001`
`x-tlp-error`	toolip main error message	Authentication failed
`x-tlp-err-msg`	toolip elaborated message and actions	Check your credentials or your account status

How to View HTTP Headers

Using `curl`

You can check the response headers using the curl command with the -v (verbose) or -i (headers only) options:

curl -v [your_request_here]

curl -i [your_request_here]

Accessing Headers in Code

If you’re using a programming language, you can retrieve Toolip error headers just like any other HTTP headers.

Common Proxy Errors

HTTP 400 – Bad Request

x-tlp-err-code	x-tlp-error	x-tlp-err-msg
`client_10060`	Proxy Error: ip_requested_not_allocated_by_customer	Requested IP `##.##.##.##` is not allocated to this zone. Select an IP that is allocated to this zone or skip the -ip parameter in proxy username

HTTP 401 – Unauthorized

x-tlp-err-code	x-tlp-error	x-tlp-err-msg
`client_10050`	Auth failed: IP blacklisted [IP]	Auth Failed IP blacklisted: [IP]

HTTP 403 – Forbidden

x-tlp-err-code	x-tlp-error	x-tlp-err-msg
`client_10070`	No Protocol	Protocol was missing from original request. Please add either HTTP or HTTPS and retry
`client_10080`	No Destination Host	No destination host. Destination host is missing or incorrect. Check your request parameters and try again
`client_10090`	You are trying to use Scraping Browser zone as regular proxy	You are trying to use Scraping Browser zone as regular proxy. A browser should be used to access this zone
`policy_20010`	Bad protocol	The protocol you are using to access our proxy is not supported. toolip supports HTTP, HTTPS & SOCKS5 upon special approval. Please fix your protocol and try again
`policy_20020`	Bad port	Bad Port used

HTTP 407 – Proxy Authentication Required

x-tlp-err-code	x-tlp-error	x-tlp-err-msg
`client_10000`	Authentication failed	Invalid authentication: check credentials and retry. Toolip credentials include your account ID, zone name and password
`client_10001`	Invalid Auth	Invalid authentication: check credentials and retry
`client_10010`	Proxy Authentication Required	No proxy credentials provided. Please add credentials and try again.
`client_10020`	Account is suspended	Login to https://toolip.io/dashboard to activate your account
`client_10030`	Authentication failed	You are not allowed to access our API via this IP. Please verify your settings or whitelist this IP.
`client_10040`	KYC Required	KYC Required

HTTP 429 – Too Many Requests

x-tlp-err-code	x-tlp-error	x-tlp-err-msg
`client_10110`	Your limited trial mode account exceeded the allowed rate limits	Your limited trial mode account exceeded the allowed rate limits

TOOLIP DOCUMENTATION

PRODUCTS

GENERAL

Proxy Errors Troubleshooting

Toolip Requires Host:Port – IP:Port is Not Supported

Correct Format:

Incorrect Format:

Why Hostnames?

HTTP Header Fields

How to View HTTP Headers

Using `curl`

Accessing Headers in Code

Common Proxy Errors

HTTP 400 – Bad Request

HTTP 401 – Unauthorized

HTTP 403 – Forbidden

HTTP 407 – Proxy Authentication Required

HTTP 429 – Too Many Requests

​Toolip Requires Host:Port – IP:Port is Not Supported

​ Correct Format:

​Incorrect Format:

​Why Hostnames?

​HTTP Header Fields

​How to View HTTP Headers

​Using curl

​Accessing Headers in Code

​Common Proxy Errors

​HTTP 400 – Bad Request

​HTTP 401 – Unauthorized

​HTTP 403 – Forbidden

​HTTP 407 – Proxy Authentication Required

​HTTP 429 – Too Many Requests

Toolip Requires Host:Port – IP:Port is Not Supported

Correct Format:

Incorrect Format:

Why Hostnames?

HTTP Header Fields

How to View HTTP Headers

Using `curl`

Accessing Headers in Code

Common Proxy Errors

HTTP 400 – Bad Request

HTTP 401 – Unauthorized

HTTP 403 – Forbidden

HTTP 407 – Proxy Authentication Required

HTTP 429 – Too Many Requests