Response Codes

​

HTTP Response Codes

​

Success Codes

​

Client Error Codes

​

400 - Bad Request

• Missing account name, pipeline name, or password
• Incorrect connection string format
• Missing target URL

# Verify your connection string format
http://account-{accountName}-pipeline-{pipelineName}:{password}@ip.nimbleway.com:7000

​

401 - Unauthorized

• Target site requires login credentials
• Session expired on target site
• Invalid credentials for target site

• Verify you’re providing correct credentials for the target website
• This is different from proxy authentication (407)

​

402 - Payment Required

• Check your account balance in the Nimble dashboard
• Contact your account executive to add credits or increase quota
• Upgrade your plan if needed

​

403 - Forbidden

• Pipeline is disabled
• Target site is on Nimble’s forbidden list
• Account suspended

• Check pipeline status in dashboard
• Verify target URL is not restricted
• Contact your account manager for details

​

404 - Not Found

• Incorrect target URL
• Page doesn’t exist on target site
• Typo in URL

# Verify the target URL is correct
curl -vvv -x http://account-accountName-pipeline-pipelineName:[email protected]:7000 \
  https://correct-url.com/path

​

407 - Proxy Authentication Required

• Incorrect account name
• Wrong pipeline name
• Invalid pipeline password
• IP not in allowlist (for IP authentication)

# Verify your proxy credentials
account name: your-company
pipeline name: residential
password: your-pipeline-password

# Test with correct credentials
curl -vvv -x http://account-yourcompany-pipeline-residential:[email protected]:7000 \
  https://ipinfo.io/json

​

Server Error Codes

​

500 - Internal Proxy Server Error

• Retry the request
• If issue persists, contact Nimble support
• Check status page for known issues

​

502 - Bad Gateway

• Target website is down or misconfigured
• Target server returned malformed response

• Verify target website is accessible
• Try a different target to confirm proxy is working
• Retry after a delay

​

503 - Service Unavailable

• Implement retry logic with exponential backoff
• Contact support if consistently experiencing 503 errors
• Check status page for service disruptions

​

504 - Gateway Timeout

• Target website is slow or unresponsive
• Network connectivity issues
• Server overload on target site

• Increase request timeout in your client
• Retry the request
• Try targeting a different page to verify proxy connectivity

​

Proxy-Specific Codes

​

522 - Connect Timeout

• Network connectivity issues between client and proxy
• Firewall blocking connection
• DNS resolution issues

• Check your network connection
• Verify firewall allows connections to ip.nimbleway.com:7000
• Test basic connectivity: ping ip.nimbleway.com

​

525 - No IP Found

• Requested location has no available IPs
• Too specific geotargeting parameters
• No IPs available in specified city/state

# If city targeting fails, try state or country only
# Instead of:
-country-US-state-WY-city-cheyenne

# Try:
-country-US-state-WY

# Verify location availability via Admin API
GET /location/cities

​

Error Handling Best Practices

import requests
from time import sleep

def make_request_with_retry(url, proxies, max_retries=3):
    for attempt in range(max_retries):
        try:
            response = requests.get(url, proxies=proxies, timeout=30)

            # Retry on specific error codes
            if response.status_code in [502, 503, 504, 522]:
                sleep(2 ** attempt)  # Exponential backoff
                continue

            return response
        except requests.exceptions.RequestException as e:
            if attempt == max_retries - 1:
                raise
            sleep(2 ** attempt)

    return None

response = requests.get(url, proxies=proxies)

if response.status_code == 407:
    print("Proxy authentication failed. Check credentials.")
    # Log error, alert ops team
elif response.status_code == 402:
    print("Credits exhausted. Contact billing.")
    # Send notification to billing team

import logging

logger = logging.getLogger(__name__)

response = requests.get(url, proxies=proxies)

if response.status_code >= 400:
    logger.error(f"Request failed: {response.status_code} - {url}")
    logger.error(f"Response body: {response.text}")

def get_with_fallback_location(url, proxies_config):
    locations = [
        'country-US-state-CA-city-losangeles',
        'country-US-state-CA',
        'country-US',
        ''  # No location targeting
    ]

    for location in locations:
        proxy_user = f"account-name-pipeline-residential"
        if location:
            proxy_user += f"-{location}"

        proxies = {
            'http': f'http://{proxy_user}:[email protected]:7000'
        }

        response = requests.get(url, proxies=proxies)

        if response.status_code != 525:
            return response

    raise Exception("No IPs available for any location")

​

Quick Reference Table

​

Need Help?