Proxy Errors Troubleshooting
Explore the catalog of toolip HTTP errors, including error codes, descriptions, and actions to resolve common proxy issues.
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:
IP:Port connectionIncorrect Format:
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:
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 |