Bright Data HTTP Errors

HTTP Header Fields

The following fields are returned upon and HTTP or HTTPS requests:

FieldDescriptionExamples
HTTP ErrorThe protocol error numbers404 or 502
x-brd-err-codeBright data module and error code numberclient_10001
x-brd-errorBright data main error messageAuthentication failed
x-brd-err-msgBright data elaborated message and actionsAuthentication 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-codex-brd-errorx-brd-err-msg
client_10001Invalid AuthInvalid authentication: check credentials and retry
client_10010Proxy Authentication RequiredNo proxy credentials provided. Please add credentials and try again.
client_10020Account is suspended. Login to brightdata.com/cp/setting/billing to activate your accountAccount is suspended. Login to https://brightdata.com/cp/setting/billing) to activate your account
client_10030Authentication failedYou are not allowed to access our API via this IP. Please verify your settings or whitelist this IP.
client_10040KYC Required. Please visit http://brighdata.com/cp/kyc and ensure you are verifiedKYC Required. Please visit http://brighdata.com/cp/kyc and ensure you are verified

HTTP Error 401

x-brd-err-codex-brd-errorx-brd-err-msg
client_10050Auth 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-codex-brd-errorx-brd-err-msg
client_10070No ProtocolProtocol was missing from original request. Please add either HTTP or HTTPS and retry.
client_10080No Destination HostNo destination host. Destination host is missing or incorrect. Check your request parameters and try again
client_10090You are trying to use Scraping Browser zone as regular proxyYou 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_20010Bad protocolThe 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_20020Bad portBad 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-codex-brd-errorx-brd-err-msg
client_10110Your limited trial mode account exceeded the allowed rate limits. Add payment method to receive $5 credit and remove rate limits. You will not be chargedYour 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