> ## Documentation Index
> Fetch the complete documentation index at: https://docs.toolip.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Proxy Errors Troubleshooting
> Explore the catalog of toolip HTTP errors, including error codes, descriptions, and actions to resolve common proxy issues.
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](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 |