ProxyBox documentation

# HTTP proxy (use the host and port shown in your dashboard)
curl -x http://USERNAME:PASSWORD@HOST:PORT https://httpbin.org/ip

# Verify your residential IP is returned
# Response: {"origin": "73.162.xxx.xxx"}

import requests

proxies = {
    "http":  "http://USERNAME:PASSWORD@proxy.proxybox.us:8080",
    "https": "http://USERNAME:PASSWORD@proxy.proxybox.us:8080",
}

response = requests.get("https://httpbin.org/ip", proxies=proxies)
print(response.json())
# {'origin': '73.162.xxx.xxx'}

import aiohttp
import asyncio

async def fetch():
    proxy = "http://USERNAME:PASSWORD@proxy.proxybox.us:8080"
    async with aiohttp.ClientSession() as session:
        async with session.get("https://httpbin.org/ip", proxy=proxy) as resp:
            print(await resp.json())

asyncio.run(fetch())

import fetch from 'node-fetch';
import { HttpsProxyAgent } from 'https-proxy-agent';

const agent = new HttpsProxyAgent(
  'http://USERNAME:PASSWORD@proxy.proxybox.us:8080'
);

const res = await fetch('https://httpbin.org/ip', { agent });
console.log(await res.json());
// { origin: '73.162.xxx.xxx' }

import axios from 'axios';

const { data } = await axios.get('https://httpbin.org/ip', {
  proxy: {
    host: 'proxy.proxybox.us',
    port: 8080,
    auth: { username: 'USERNAME', password: 'PASSWORD' }
  }
});
console.log(data);

from selenium import webdriver
from selenium.webdriver.chrome.options import Options

options = Options()
options.add_argument('--proxy-server=http://USERNAME:PASSWORD@proxy.proxybox.us:8080')

driver = webdriver.Chrome(options=options)
driver.get('https://httpbin.org/ip')
print(driver.page_source)
driver.quit()

from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(proxy={
        "server": "http://proxy.proxybox.us:8080",
        "username": "USERNAME",
        "password": "PASSWORD",
    })
    page = browser.new_page()
    page.goto("https://httpbin.org/ip")
    print(page.content())
    browser.close()

# Request
curl -X POST https://proxybox.us/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "user@example.com", "password": "your-password"}'

# Response
{
  "token": "eyJhbGciOiJIUzI1NiIs...",
  "user": {
    "id": "usr_abc123",
    "email": "user@example.com",
    "plan": "premium"
  }
}

# List all your devices
curl https://proxybox.us/api/devices \
  -H "Authorization: Bearer YOUR_TOKEN"

# Response
{
  "devices": [
    {
      "id": "dev_xyz789",
      "name": "Home Office",
      "status": "online",
      "public_ip": "73.162.xxx.xxx",
      "firmware_version": "1.2.0",
      "last_seen": "2026-04-05T14:23:00Z"
    }
  ]
}

# Get the current proxy credentials for a device
curl https://proxybox.us/api/user/devices/dev_xyz789/proxy-creds \
  -H "Authorization: Bearer YOUR_TOKEN"

# Response
{
  "host": "relay-xx.proxybox.us",
  "port": 8080,
  "username": "px_abc456",
  "password": "sk_live_...",
  "http_proxy": "http://px_abc456:sk_live_...@relay-xx.proxybox.us:8080"
}