Proxy errors troubleshooting
Explore the catalog of Bright Data HTTP errors, including error codes, descriptions, and actions to resolve common proxy issues.
Bright Data HTTP Errors
HTTP Header Fields
The following fields are returned upon and HTTP
or HTTPS
requests:
Field | Description | Examples |
---|---|---|
HTTP Error | The protocol error numbers | 404 or 502 |
x-brd-err-code | Bright data module and error code number | client_10001 |
x-brd-error | Bright data main error message | Authentication failed |
x-brd-err-msg | Bright data elaborated message and actions | Authentication failed. Check your credentials or your account status in https://brightdata.com/cp/settings/billing` |
Getting HTTP header fields
Testing from command line
To view and test your settings, or restoring an issue, you can run a curl
command from your shell prompt and add the option flag -v
. This flag will run curl in verbose mode and print out the header fields, including the custom error code and message.
curl -v [rest of curl command options]
To see a more compact view with the header fields response only use the -i
option for curl:
curl -i [rest of curl command options]
Alternatively, you can use the nc
command to get the fields printed to screen:
echo "[tcp nc inputs]" | nc -C -v brd.superproxy.io 22225
nc inputs may include “empty” lines, those are crucil for correct testing using nc command
Accessing via programming language
Bright Data HTTP header fields can be accessed thru your programming language, as any other HTTP header field.
Error Catalog
HTTP Error 407
x-brd-err-code | x-brd-error | x-brd-err-msg |
---|---|---|
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 brightdata.com/cp/setting/billing to activate your account | Account is suspended. Login to https://brightdata.com/cp/setting/billing) 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. Please visit http://brighdata.com/cp/kyc and ensure you are verified | KYC Required. Please visit http://brighdata.com/cp/kyc and ensure you are verified |
HTTP Error 401
x-brd-err-code | x-brd-error | x-brd-err-msg |
---|---|---|
client_10050 | Auth failed: IP blacklisted [IP] | Auth Failed IP blacklisted: [IP]. Check https://brightdata.com/faq#remove-blacklist_ips to resolve |
HTTP Error 403
x-brd-err-code | x-brd-error | x-brd-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. See https://docs.brightdata.com/scraping-automation/scraping-browser/introduction for information on how to access your scraping browser zone |
policy_20010 | Bad protocol | The protocol you are using to access our proxy is not supported. Bright data supports HTTP, HTTPS & SOCKS5 upon special approval. Please fix your protocol and try again |
policy_20020 | Bad port | Bad Port used. Ports we support: https://docs.brightdata.com/proxy-networks/faqs#how-to-see-supported-ports-and-protocols |
HTTP Error 429
x-brd-err-code | x-brd-error | x-brd-err-msg |
---|---|---|
client_10110 | Your limited trial mode account exceeded the allowed rate limits. Add payment method to receive $5 credit and remove rate limits. You will not be charged | Your limited trial mode account exceeded the allowed rate limits. Add payment method to receive $5 credit and remove rate limits. You will not be charged |