# Proxidize Help Center

Docs for Proxidize Mobile Proxies and Residential Proxies, including setup, rotation, targeting, API usage, billing, troubleshooting, and legacy support.

Get to the right guide fast.

Use this help center for setup, billing, troubleshooting, and API docs.

<p align="center"><button type="button" class="button primary" data-action="search" data-icon="magnifying-glass">Search the Help Center</button></p>

<p align="center"><button type="button" class="button primary" data-action="ask" data-icon="brain-circuit">Ask the Ai</button><a href="https://status.proxidize.com/" class="button secondary" data-icon="signal">Proxidize Status Page</a></p>

### Start with your goal

<table data-view="cards"><thead><tr><th>Title</th><th>Description</th><th data-card-target data-type="content-ref">Link</th></tr></thead><tbody><tr><td>Quick start</td><td>Pick a plan, get credentials, and test your first proxy.</td><td><a href="/spaces/iAQa47xivOtQQ7mQZOnQ/pages/1VbHm5HoZzhMZ1ig6iqW">/spaces/iAQa47xivOtQQ7mQZOnQ/pages/1VbHm5HoZzhMZ1ig6iqW</a></td></tr><tr><td>Choose a product</td><td>Compare mobile and residential proxies before you buy.</td><td><a href="/spaces/iAQa47xivOtQQ7mQZOnQ/pages/Som0XjLLJBY8AQwRx6eZ">/spaces/iAQa47xivOtQQ7mQZOnQ/pages/Som0XjLLJBY8AQwRx6eZ</a></td></tr><tr><td>Set up your proxies</td><td>Connect Proxidize proxies in browsers, tools, and scripts.</td><td><a href="/spaces/iAQa47xivOtQQ7mQZOnQ/pages/35cce7baa1c32f5a6b993909c8469877d61da10d">/spaces/iAQa47xivOtQQ7mQZOnQ/pages/35cce7baa1c32f5a6b993909c8469877d61da10d</a></td></tr><tr><td>Manage billing</td><td>Handle subscriptions, invoices, payments, and account settings.</td><td><a href="/spaces/iAQa47xivOtQQ7mQZOnQ/pages/sY2hjDnWgGDqces8WwJs">/spaces/iAQa47xivOtQQ7mQZOnQ/pages/sY2hjDnWgGDqces8WwJs</a></td></tr><tr><td>Use the API</td><td>Browse API endpoints for proxy management and settings.</td><td><a href="/spaces/iAQa47xivOtQQ7mQZOnQ/pages/wAT9mU6LZJFpkpuv8JBU">/spaces/iAQa47xivOtQQ7mQZOnQ/pages/wAT9mU6LZJFpkpuv8JBU</a></td></tr></tbody></table>

### Explore by product

<table data-view="cards"><thead><tr><th>Title</th><th>Description</th><th data-card-target data-type="content-ref">Link</th></tr></thead><tbody><tr><td>Mobile Proxies</td><td>Managed U.S. mobile IPs with Per Proxy and Per GB plans.</td><td><a href="/spaces/iAQa47xivOtQQ7mQZOnQ/pages/G86vCCe5CzcsCN3CqgYC">/spaces/iAQa47xivOtQQ7mQZOnQ/pages/G86vCCe5CzcsCN3CqgYC</a></td></tr><tr><td>Residential Proxies</td><td>Residential IPs across 190+ countries with sticky or rotating sessions.</td><td><a href="/spaces/iAQa47xivOtQQ7mQZOnQ/pages/447326fd92521d72bac72640c2c1f141ab96cb34">/spaces/iAQa47xivOtQQ7mQZOnQ/pages/447326fd92521d72bac72640c2c1f141ab96cb34</a></td></tr><tr><td>Proxy Builder (Legacy)</td><td>Explore the help center for the Proxy Builder Platform.</td><td><a href="/pages/IMQSKZ7quTlMxay3xT4T">/pages/IMQSKZ7quTlMxay3xT4T</a></td></tr></tbody></table>

{% hint style="info" %}
New customers should start with Mobile Proxies or Residential Proxies.

Legacy docs stay available for existing Proxy Builder users.
{% endhint %}


# Start Here

Choose the right Proxidize docs path for setup, product selection, billing, troubleshooting, and API work.

Use this page if you want the shortest path to the right docs.

It works best for new users and first-time setup.

### If you are new to Proxidize

<table data-view="cards"><thead><tr><th>Title</th><th>Description</th><th data-card-target data-type="content-ref">Link</th></tr></thead><tbody><tr><td>Learn the basics</td><td>Understand what Proxidize proxies are and how they work.</td><td><a href="/spaces/iAQa47xivOtQQ7mQZOnQ/pages/061b03d8e2f03de4cf3bcc6470709ac99549ec53">/spaces/iAQa47xivOtQQ7mQZOnQ/pages/061b03d8e2f03de4cf3bcc6470709ac99549ec53</a></td></tr><tr><td>Choose a product</td><td>Compare mobile and residential proxies by fit and behavior.</td><td><a href="/spaces/iAQa47xivOtQQ7mQZOnQ/pages/Som0XjLLJBY8AQwRx6eZ">/spaces/iAQa47xivOtQQ7mQZOnQ/pages/Som0XjLLJBY8AQwRx6eZ</a></td></tr></tbody></table>

### When you are ready to connect

<table data-view="cards"><thead><tr><th>Title</th><th>Description</th><th data-card-target data-type="content-ref">Link</th></tr></thead><tbody><tr><td>Quick start</td><td>Go from plan choice to your first live connection.</td><td><a href="/spaces/iAQa47xivOtQQ7mQZOnQ/pages/1VbHm5HoZzhMZ1ig6iqW">/spaces/iAQa47xivOtQQ7mQZOnQ/pages/1VbHm5HoZzhMZ1ig6iqW</a></td></tr><tr><td>Set up your proxies</td><td>Connect in browsers, anti-detect tools, and scripts.</td><td><a href="/spaces/iAQa47xivOtQQ7mQZOnQ/pages/35cce7baa1c32f5a6b993909c8469877d61da10d">/spaces/iAQa47xivOtQQ7mQZOnQ/pages/35cce7baa1c32f5a6b993909c8469877d61da10d</a></td></tr><tr><td>Use the extension</td><td>Manage and test sessions directly in your browser.</td><td><a href="/spaces/iAQa47xivOtQQ7mQZOnQ/pages/8aee3d8dbbd15da87ff57825ba76ba88caedcb0d">/spaces/iAQa47xivOtQQ7mQZOnQ/pages/8aee3d8dbbd15da87ff57825ba76ba88caedcb0d</a></td></tr></tbody></table>

### Need something specific?

* [Account & Billing](/account-and-billing/overview)
* [Troubleshooting](/legacy-products/gen-2/troubleshooting)
* [Proxidize API](/proxidize-rest-api/proxidize-api)

{% hint style="info" %}
Legacy docs are for existing Proxy Builder customers.

If you are new, start with the managed proxy guides instead.
{% endhint %}


# Overview

Welcome to the Proxidize Help Center. This section takes you from zero to a working proxy setup, whether you're new to proxies or just new to Proxidize.

Proxidize offers two fully managed proxy products ( **Mobile Proxies** and **Residential Proxies** ) plus **Proxy Builder**, a legacy self-hosted platform for existing customers. Everything is managed from your dashboard at [app.proxidize.com](https://app.proxidize.com/).

### Start here <a href="#start-here" id="start-here"></a>

***

* **New to proxies?** Learn the basics in [What are Proxidize Proxies?](/getting-started/what-are-proxidize-proxies)
* **Not sure which product you need?** Use [Choose Between Mobile and Residential Proxies](/getting-started/choose-between-mobile-and-residential-proxies)
* **Ready to go?** Follow the [Quick Start](/getting-started/quick-start-with-proxidize-proxies) from picking a plan to your first connection
* **Need to connect your proxies?** See [Setting Up Your Proxidize Proxies](/getting-started/setting-up-your-proxidize-proxies)
* **Accessing Financial or HR sites?** Complete [KYC Verification](/getting-started/kyc-verification-for-proxidize-proxy-users)

#### What you'll be able to do

***

By the end of this section you'll know which product fits your use case, how to get your proxy credentials, and how to connect your proxies to a browser, phone, script, or automation tool.

If you get stuck at any point, you can reach the team from the live chat at [app.proxidize.com](https://app.proxidize.com/) or by emailing <support@proxidize.com>.<br>


# What are Proxidize Proxies?

Learn what proxies are and how Proxidize mobile and residential proxies work, including CGNAT, IP authenticity, and common use cases.

A proxy routes your internet traffic through another device, so the website you visit sees that device's IP address instead of your own. Proxidize provides proxies built on real mobile and residential networks, which makes your traffic look like an ordinary user rather than automated or datacenter traffic.

### Mobile Proxies

***

Mobile proxies route traffic through real SIM-Based devices on U.S. mobile ISP networks (4G/5G), so your traffic appears to come from a genuine upstream device running one of the Major US-ISPs.

Mobile ISPs use **CGNAT**, meaning many real users share the same public IP. This is a strength: because a mobile IP is shared across many genuine subscribers, platforms can't easily block it without affecting real users. That's what makes mobile proxies the most authentic, hardest-to-block option.&#x20;

Mobile proxies are currently available in the **United States only**.

Learn more in [Mobile Proxies](/proxidize-proxies/mobile-proxies).

### Residential Proxies

***

Residential proxies use ISP IP addresses, sourced ethically and with consent through Proxidize's bandwidth-sharing app and partner apps. Because the traffic comes from ordinary ISP connections, it's trusted by most websites.

Residential proxies cover **190+ countries** with city-level and ISP-level targeting, which makes them ideal for large-scale, geo-targeted work anywhere in the world.

Learn more in [Residential Proxies.](/proxidize-proxies/residential-pergb)

### Why mobile and residential IPs are trusted

***

Both types use real IPs from real networks, so they blend in with normal user traffic. Datacenter IPs, by contrast, come from hosting providers and are easy for websites to identify and block. Mobile IPs are considered the most premium because of ISP-grade infrastructure and natural IP rotation; residential IPs offer the widest global coverage.

### What people use them for

***

* Ad verification
* Web scraping and large-scale data collection
* Price and SEO monitoring
* Market research and AI/LLM data collection
* Geo-targeted testing
* Brand Protection

### Which one should you use?

***

If you need U.S. mobile IPs and your use case requires legit mobile traffic choose Mobile. \
If you need coverage outside the U.S. or the widest reach, choose Residential. For a full breakdown, see [Choose Between Mobile and Residential Proxies](/getting-started/choose-between-mobile-and-residential-proxies).

### Plans and Pricing

***

Proxidize Proxies offer flexible pricing plans to cater to businesses of all sizes, from startups to large enterprises. Whether you need a small pool of proxies for occasional use or a large-scale network for intensive tasks, we have a plan for you. Detailed pricing information is available on our website <https://proxidize.com/pricing/>


# Choose Between Mobile and Residential Proxies

Compare Proxidize Mobile and Residential proxies by coverage, plans, IP behavior, and use case to pick the right product for your workflow.

Proxidize offers two managed proxy products: **Mobile Proxies** and **Residential Proxies**. This guide helps you pick the right one based on where you need IPs, how hard they need to be to detect, and how you plan to use them.

If you're still learning the basics, start with [What are Proxidize Proxies?](/getting-started/what-are-proxidize-proxies)

### Quick answer

***

* **Choose Mobile Proxies** for the most authentic, hardest-to-block IPs, ideal for QA and app testing, ad verification, Market Research, and other. Available in the United States only.
* **Choose Residential Proxies** for broad global coverage across **190+ countries** with city and ISP targeting, ideal for scraping, monitoring, and geo-targeted work, especially outside the US.

### At a glance

***

<table data-search="false"><thead><tr><th></th><th>Mobile Proxies</th><th>Residential Proxies</th></tr></thead><tbody><tr><td><strong>IP source</strong></td><td>4G/5G mobile IPs</td><td>Real residential-ISP IPs</td></tr><tr><td><strong>Coverage</strong></td><td>United States only, city-level</td><td>190+ countries, city + ISP level</td></tr><tr><td><strong>Plans</strong></td><td>Per Proxy or Per GB</td><td>Per GB</td></tr><tr><td><strong>Protocols</strong></td><td>HTTP, SOCKS5 (UDP over SOCKS5 supported)</td><td>HTTP, SOCKS5</td></tr><tr><td><strong>IP behavior</strong></td><td>ISP-controlled; a sticky IP typically holds ~1–4 hours</td><td>ISP-controlled; a sticky IP typically holds ~1–3 hours</td></tr><tr><td><strong>Data</strong></td><td><ul><li>Per Proxy: unlimited with a 50 GB fair-use threshold</li><li>Per GB: pay per GB, no rollover</li></ul></td><td>Pay per GB, unused data rolls over and never expires</td></tr><tr><td><strong>Best for</strong></td><td><ul><li>ad verification.</li><li>mobile app/QA testing.</li><li>SEO/SERP Monitoring </li></ul></td><td><ul><li>Global/geo-specific browsing and scraping.</li><li>Travel/fare aggregation.</li><li>Global market research</li></ul></td></tr></tbody></table>

### When to choose Mobile Proxies

***

Mobile proxies route traffic through real devices on U.S. ISP networks. Because ISPs share IPs across many real users (CGNAT), mobile IPs are very hard for platforms to block, which makes them the strongest choice for any workflow that benefits from a genuine mobile identity.

They come in two plans:

* **Per Proxy:** a dedicated proxy with its own controls and rotation options (rotate button, scheduled interval, or rotation URL). Best for long-running workflows.
* **Per GB:** usage-based access to the shared mobile pool through Access Points. Best for variable or large-scale mobile workloads.

Mobile proxies are U.S-only. For any other country, use Residential. To compare the two plans in depth, see [Per Proxy vs Per GB](/proxidize-proxies/perproxy-vs-pergb).

### When to choose Residential Proxies

***

Residential proxies use residential-ISP IPs from a pool spanning 190+ countries, with city-level and ISP-level targeting. They're the right choice for:

* [Web scraping](https://proxidize.com/use-cases/web-scraping/) and large-scale data collection
* [Price monitoring](https://proxidize.com/use-cases/price-monitoring/) and [SEO monitoring](https://proxidize.com/use-cases/seo-monitoring/)
* [Market research](https://proxidize.com/use-cases/market-research/) and [AI/LLM data collection](https://proxidize.com/use-cases/ai-llm-training/)
* [Brand Protection Monitoring](https://proxidize.com/use-cases/brand-protection-monitoring/)
* Any work that needs coverage outside the United States

Residential is Per GB only, and unused data rolls over, it never expires.

### Still not sure?

***

* Need U.S. mobile IPs or account-safe identities → **Mobile**
* Need a specific country outside the U.S., or the widest coverage → **Residential**
* Want the lowest entry price → **Residential Per GB**, our lowest perGB rate

Both products work with any proxy-compatible tool and are managed from your dashboard at [app.proxidize.com](https://app.proxidize.com). When you're ready, follow the [Quick Start](/getting-started/quick-start-with-proxidize-proxies).

### Related

* [What are Proxidize Proxies?](/getting-started/what-are-proxidize-proxies)
* [Quick Start with Proxidize Proxies](/getting-started/quick-start-with-proxidize-proxies)
* [Setting Up Your Proxidize Proxies](/getting-started/setting-up-your-proxidize-proxies)


# Quick Start with Proxidize Proxies

A step-by-step walkthrough from choosing a plan to getting your credentials, connecting, and testing your first Proxidize proxy.

This guide walks you from a new account to a working proxy, step by step.\
Each step links to a deeper guide if you want more detail.

### 1. Choose your product

***

First, decide whether you need Mobile or Residential proxies:

* **Mobile Proxies:** U.S. mobile IPs. Best for ad verification, SEO Monitoring or any workflows that need Mobile IPs. United States only.
* **Residential Proxies:** Premium residential ISP IPs across 195+ countries. Best for global scraping, monitoring, and geo-targeted work.

Not sure? See [Choose Between Mobile and Residential Proxies](/getting-started/choose-between-mobile-and-residential-proxies).

### 2. Pick a plan

***

* **Mobile** comes as **Per Proxy** or **Per GB**.
  * **Per Proxy** gives you a dedicated proxy with full rotation controls. Best for when you need a more predictable cost and a known monthly expense instead of paying per GB where your bill may fluctuate
  * **Per GB** gives you usage-based access to the shared pool. Best for scale.
* **Residential** is **Per GB** only.

Learn how the plans differ in [Mobile Proxies](/proxidize-proxies/mobile-proxies) and [Residential Proxies](/proxidize-proxies/residential-pergb).

### 3. Create your account and subscribe

***

Create an account at [app.proxidize.com](https://app.proxidize.com), then subscribe to your chosen plan.

Proxies activate immediately after purchase.

If you need help buying, see [Billing and Subscriptions](/account-and-billing/billing-and-subscriptions).

### 4. Get your proxy credentials

***

All your proxies live in one dashboard at [app.proxidize.com](https://app.proxidize.com).

On **Per Proxy**, click the copy button next to your chosen protocol — **HTTP** or **SOCKS5**.

On **Per GB**, find your proxies in the **Formatted Proxy List** section.

Proxies come in one of these formats:

* `IP:Port:Username:Password`
* `Username:Password@IP:Port`

Credentials are generated automatically and stay valid even when the IP changes.

See [Setting Up Your Proxidize Proxies](/getting-started/setting-up-your-proxidize-proxies) for the full walkthrough.

### 5. Connect your proxy

***

Add your proxy to a browser, phone, script, or automation tool.

{% hint style="warning" %}
Proxy traffic can only reach destination ports `80` and `443`.
{% endhint %}

The [Setting Up Your Proxidize Proxies](/getting-started/setting-up-your-proxidize-proxies) guide covers the main setup methods, including browser-based and tool-based workflows.

### 6. Test the connection

***

Confirm the proxy works by checking that the IP it returns matches your selected location.

The easiest option is the Proxidize Proxy Extension.

You can also run a quick command-line test.

Both methods are covered in [Setting Up Your Proxidize Proxies](/getting-started/setting-up-your-proxidize-proxies).

### 7. Start small, then scale

***

Run a small test first. Start with a few requests from one location, and confirm everything works before increasing volume. This makes it easier to catch configuration issues early.

### <mark style="color:$primary;">Need a hand?</mark>

If you access financial, HR, or transactional sites, or need non-standard ports, you may need to complete [KYC Verification](/getting-started/kyc-verification-for-proxidize-proxy-users) first.

For anything else, reach the team through live chat at [app.proxidize.com](https://app.proxidize.com) or email <support@proxidize.com>.


# Setting Up Your Proxidize Proxies

How to find your proxy credentials and connect Proxidize proxies on desktop and in automation tools.

Once you have an active plan, connecting your proxies takes just a few minutes. This guide shows you where to find your credentials and connect them on desktop or in automation tools.

{% stepper %}
{% step %}

## Find your proxies and copy your credentials

All of your proxies *( Mobile, Residential, and Proxy Builder (Legacy) )* live in one place: your dashboard at [app.proxidize.com](https://app.proxidize.com). Open the product you purchased to see its proxies.

Getting your proxy takes just a click. The exact spot depends on your plan. Either way, proxies are copied in one of two formats:

* `IP:Port:Username:Password`
* `Username:Password@IP:Port`

**On the Per Proxy plan:** next to each proxy you'll see a copy button for each protocol, **HTTP** and **SOCKS5**. Press the copy button for the protocol you want, and the full proxy is copied to your clipboard in your chosen format. No manual assembly needed.

{% hint style="info" %}
Credentials are generated automatically and don't change when your IP rotates, so you never need to update your tools after a rotation.
{% endhint %}

<figure><img src="/files/XkHmmHk4Js9Lq407DD6q" alt=""><figcaption></figcaption></figure>

**On Per GB plans:** all of your proxies are listed together under the **Formatted Proxy List** section of the dashboard. Open it to see every proxy in one place, pick your protocol and format, and copy them individually or export them in bulk.

***

**Authentication options:**

* **Username / password:** the default. Works in any proxy-compatible tool.
* **IP Whitelist:** authenticate by your public IP instead of a username and password. Best for servers and automation. If your public IP changes, add the new one to your allowlist or access will stop.
  {% endstep %}

{% step %}

## Choose how to connect

The best connection method depends on your device.

{% hint style="warning" %}
Proxy traffic can only reach destination ports `80` and `443`.
{% endhint %}

#### 1. On a desktop (PC or Mac)

You have two recommended options:

**Option A:** [**Proxidize Proxy Extension**](/proxidize-proxies/proxidize-proxy-extension)**.** A lightweight browser extension that lets you connect to a proxy in one click, switch between proxies, and test them, without changing your system settings. Best for quick setups and testing.

* [Proxidize Proxy Extension for Chrome](https://chromewebstore.google.com/detail/proxidize-proxy-extension/gccdbcipcjgfnjlegofdhflkifgkdmpb)
* [Proxidize Proxy Extension for Firefox](https://addons.mozilla.org/en-US/firefox/addon/proxidize-proxy-extension/)

**Option B: an anti-detect browser.** If you manage multiple accounts or need separate browser profiles, use an anti-detect browser. Each profile gets its own proxy, keeping identities cleanly separated. Add your Proxidize credentials to each profile's proxy settings.

#### 2. In scripts and automation tools

Proxidize proxies work with any proxy-compatible tool. Use the format most tools expect:

```
http://username:password@hostname:port
```

The exact input format varies by tool, check that tool's own documentation.
{% endstep %}

{% step %}

## Test your connection

Before running a full workflow, confirm the proxy works. You can:

* Use the **Proxidize Proxy Extension** to connect and view the egress IP, or
* Run a quick command-line check:

```
curl -x http://username:password@hostname:port https://api.ipify.org
```

If the returned IP is different than your local IP, you're connected.
{% endstep %}
{% endstepper %}

***

### Troubleshooting

If a proxy won't connect, first re-check the username, password, protocol, and port. Then rotate the proxy (Per Proxy) or switch the session key or Access Point (Per GB), and test again with a curl request to isolate whether the issue is the tool or the proxy.

If your target uses a port other than `80` or `443`, the proxy cannot reach it.

For more help, reach the team via live chat at [app.proxidize.com](https://app.proxidize.com) or email <support@proxidize.com>.

### Related

* [Quick Start with Proxidize Proxies](/getting-started/quick-start-with-proxidize-proxies)
* [Choose Between Mobile and Residential Proxies](/getting-started/choose-between-mobile-and-residential-proxies)
* [KYC Verification](/getting-started/kyc-verification-for-proxidize-proxy-users)


# Setting up your Proxidize Proxies on IOS

Learn how to use your Proxidize Proxies on your IOS device by configuring your Wi-Fi settings to add a proxy.

This guide shows you how to set up your Proxidize proxy on an iPhone or iPad.

On iOS, proxies are configured **directly inside your Wi-Fi network settings**. This is because Proxidize proxies are secured to allow web traffic only, connections are permitted over **port 80 (HTTP)** and **port 443 (HTTPS)**, and other ports are blocked. Due to these port restrictions, configuring the proxy on the Wi-Fi network is currently the reliable way to use Proxidize proxies on iOS.

{% hint style="warning" %}
**Read This First**&#x20;

**What to Expect** After you apply the proxy, your iPhone may show a **"No Internet Connection"** warning, or the Wi-Fi icon may look inactive. **This is normal and expected.** It happens because iOS checks connectivity using ports that the proxy blocks. Your proxy is still working, you use it by **opening a web browser** (Safari or Chrome) and browsing normally.
{% endhint %}

By the end of this guide, your device will route web browsing through your Proxidize proxy over your Wi-Fi network.

***

### Prerequisites

Before you start, make sure you have the following ready:

* [ ] Your Proxidize **HTTP** Proxy Credentials
* [ ] **An iPhone or iPad** connected to a **Wi-Fi network**

{% hint style="info" %}
**💡 Where do I find my proxy details?** Your host, port, username, and password are shown in your Proxidize dashboard. Keep them nearby before you begin. See [Setting Up Your Proxidize Proxies](/getting-started/setting-up-your-proxidize-proxies) for more detials.
{% endhint %}

***

{% stepper %}
{% step %}

### Open Wi-Fi Settings and Select Your Network

First, make sure you are connected to the Wi-Fi network you want to use.

1. Open the **Settings** app on your iPhone or iPad.
2. Tap **Wi-Fi**.
3. Connect to your Wi-Fi network if you are not already connected.

{% hint style="warning" %}
**⚠️ Wi-Fi Only**&#x20;

This method applies the proxy to **Wi-Fi only**. It does not apply to cellular (mobile) data. You must be on Wi-Fi to use the proxy.
{% endhint %}
{% endstep %}

{% step %}

### Open the Network Configuration

Now open the detailed settings for your connected network.

1. Next to your connected Wi-Fi network name, tap the **ⓘ (info) icon**.
2. Scroll to the bottom of the page until you see the **HTTP Proxy** section.

<figure><img src="/files/GtUN4e5QYhCErIQ8XWBm" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Configure the HTTP Proxy

This is where you enter your Proxidize proxy details.

1. In the **HTTP Proxy** section, tap **Configure Proxy**.
2. Select **Manual**.
3. Enter your proxy details:
   * **Server:** your proxy host or IP (e.g. `pg.proxi.es`)
   * **Port:** your HTTP proxy port (e.g. `20000`)
4. Turn **Authentication** **ON**.
5. Enter your **Username** and **Password**.
6. Tap **Save** in the top-right corner.

<figure><img src="/files/eOpaB4NJwv6hJhBBHGGs" alt="" width="369"><figcaption></figcaption></figure>

{% hint style="warning" %}
**Critical Step**&#x20;

Make sure **Authentication** is turned ON and your username and password are entered correctly. Without them, the proxy will reject the connection.
{% endhint %}
{% endstep %}

{% step %}

### Verifying Your Connection

Your proxy is now active on this Wi-Fi network.

{% hint style="info" %}
**Ignore the "No Internet" Warning** At this point your iPhone may show **"No Internet Connection"** or a similar message. **Do not worry, this is expected.** The proxy only allows web traffic, so system checks fail, but browsing works.
{% endhint %}

To confirm the proxy is working:

1. Open a web browser (**Safari** or **Chrome**).
2. Visit one of these sites:
   * `https://whoer.net`
   * `https://whatismyip.com`
3. Check the IP address shown on the page.

If the IP address matches your Proxidize proxy location, your setup is working correctly.

{% hint style="info" %}
**💡 Remember**&#x20;

Web browsing through a browser is how you use the proxy on iOS. Other apps that rely on non-web ports may not work while the proxy is active.
{% endhint %}
{% endstep %}
{% endstepper %}

***

### Tips & Troubleshooting

#### How to turn the proxy off

When you want to stop using the proxy:

1. Go to **Settings → Wi-Fi**.
2. Tap the **ⓘ (info) icon** next to your network.
3. Tap **Configure Proxy** and select **Off**.
4. Tap **Save**.

Your normal internet connection will return immediately.

#### Quick troubleshooting checklist

If your connection is not working, check these in order:

1. **Are you on the right Wi-Fi network?** The proxy applies only to the specific network you configured. Other Wi-Fi networks and cellular data are not affected.
2. **Is Authentication ON?** Confirm the toggle is enabled and your username and password are correct. They are case-sensitive.
3. **Is the port your HTTP port?** The iOS Wi-Fi proxy uses HTTP only, do not enter a SOCKS port.
4. **Test in a browser.** Remember that browsing in Safari or Chrome is the correct way to confirm the proxy, ignore the "No Internet" system warning.

***

### Need Help?

If you have any questions, concerns, or need further clarification, feel free to reach out to us via live chat or email us directly at <support@proxidize.com>.


# KYC Verification for Proxidize Proxy Users

Understand KYC and KYB verification, proxy access rules, and restricted destinations.

To keep the Proxidize network safe and lawful, all customers must verify their identity.

KYC is required before you can access proxy services. KYB may be required for higher usage or sensitive categories.

Verification helps keep Proxidize proxies safe and compliant.

Every customer must complete KYC after purchasing a proxy plan. Some business use cases also require KYB approval.

### KYC and KYB

**KYC** verifies an individual identity. It is required for proxy access.

**KYB** verifies a business and its use case. It is required for sensitive categories or unlimited connection threads.

**KYC** verifies an individual identity. It is required for every customer and activates proxy access for supported use cases.

**KYB** verifies a business and its use case. Request KYB if you need access to restricted website categories.

* [How to Complete KYC Verification](/getting-started/kyc-verification-for-proxidize-proxy-users/how-to-complete-kyc-verification)
* [How to Request KYB Verification](/getting-started/kyc-verification-for-proxidize-proxy-users/how-to-request-kyb-verification)

### Verification tiers

| Tier             | Who it is for                                           | What you provide                                             | Access                                                         |
| ---------------- | ------------------------------------------------------- | ------------------------------------------------------------ | -------------------------------------------------------------- |
| **Tier 1 — KYC** | All proxy users                                         | Government-issued photo ID, camera, and country of residence | General web destinations with limited connection threads       |
| **Tier 2 — KYB** | Businesses needing higher usage or sensitive categories | Business and entity verification details                     | Unlimited connection threads and verification-gated categories |

Complete Tier 1 in your account. Contact Sales to start Tier 2.

### Restricted categories

These categories remain blocked for every customer:

* Adult content
* Survey sites
* Government sites
* Military sites

Tier 2 verification may unlock financial services, HR and recruitment, and consumer-review websites.

### What verification allows

After KYC approval, you can use proxies for supported use cases.

**KYB** may grant access to financial websites and services, HR platforms, and feedback websites.\
KYB also provides a higher account-wide thread limit.

Approval depends on your business and use case.

### What verification does not change

The following rules apply to every customer:

* Only ports `80` and `443` are available.
* Government websites with `.gov` domains are blocked.
* Military websites with `.mil` domains are blocked.
* Survey-for-money websites are blocked.
* Adult-content websites are blocked.

KYC and KYB approval do not change these restrictions.

### Thread limits

KYC customers have a limited number of concurrent threads across their accounts.

KYB customers have a higher account-wide thread limit after approval.

### Quick FAQ

<details>

<summary>Do I need KYC after purchasing a proxy plan?</summary>

Yes. KYC is required before you can use proxy services.

</details>

<details>

<summary>Can KYC or KYB enable other ports?</summary>

No. Only ports `80` and `443` are available.

</details>

<details>

<summary>Does KYB remove every website restriction?</summary>

No. Adult, survey, government, and military categories remain blocked.

</details>

### Related articles

* [How to Complete KYC Verification](/getting-started/kyc-verification-for-proxidize-proxy-users/how-to-complete-kyc-verification)
* [How to Request KYB Verification](/getting-started/kyc-verification-for-proxidize-proxy-users/how-to-request-kyb-verification)
* [How to Subscribe to a Proxidize Plan](/account-and-billing/billing-and-subscriptions/how-to-subscribe-to-a-proxidize-plan)

### <mark style="color:$primary;">Need help?</mark>

Reach us through live chat or email at **<support@proxidize.com>**.


# How to Complete KYC Verification

Complete required KYC verification to activate your Proxidize proxy access.

Complete Know Your Customer (KYC) verification after purchasing a Proxidize proxy plan.

KYC is required for every customer. It activates proxy access for supported use cases.

### Before you start

Make sure you have:

* access to the Proxidize account tied to your subscription
* a device camera for document and selfie capture

Use a valid government-issued photo ID. You also need your current country of residence.

| Your country of residence                                                                                              | Accepted documents                              |
| ---------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- |
| United States, Canada, United Kingdom, Australia, New Zealand, any European Union member state, Norway, or Switzerland | Passport, national ID card, or driver's license |
| Any other supported country                                                                                            | Passport only                                   |

**KYC is unavailable** for residents of Afghanistan, Belarus, China, Cuba, Hong Kong, Iran, Macau, North Korea, Russia, Syria, and Venezuela.

Use a document based on your location:

* **Customers in the listed supported countries:** an ID card, driver's license, or passport
* **Customers in other supported countries:** a valid passport

### Complete KYC verification

{% stepper %}
{% step %}

### Open your Proxidize account

Log in to [app.proxidize.com](https://www.app.proxidize.com/) with the account tied to your proxy subscription.

Then open **Settings**.

![](https://146351401.fs1.hubspotusercontent-eu1.net/hubfs/146351401/image-png-Jan-08-2026-02-53-09-5748-PM.png)
{% endstep %}

{% step %}

### Start verification

In **Settings**, find the **Verify** section.

If your account is not verified, click **Verify**.

This opens the verification platform. Click **Start** to continue.

![](https://146351401.fs1.hubspotusercontent-eu1.net/hubfs/146351401/image-png-Jan-07-2026-01-43-07-8176-PM.png)
{% endstep %}

{% step %}

### Select your country

Choose the country where you currently live.

Then click **Continue on this device**.

![](https://146351401.fs1.hubspotusercontent-eu1.net/hubfs/146351401/image-png-Jan-07-2026-02-52-40-8302-PM.png)

![](https://146351401.fs1.hubspotusercontent-eu1.net/hubfs/146351401/image-png-Jan-07-2026-01-50-41-4611-PM.png)
{% endstep %}

{% step %}

### Choose your document

Select the document type you want to use.

Select a document accepted for your country of residence.

Supported document types are listed in [KYC Verification for Proxidize Proxy Users](/getting-started/kyc-verification-for-proxidize-proxy-users).

Customers in other supported countries must select a passport.

Customers in the listed supported countries can use:

* an ID card
* a driver's license
* a passport

![](https://146351401.fs1.hubspotusercontent-eu1.net/hubfs/146351401/image-png-Jan-07-2026-01-46-28-7806-PM.png)
{% endstep %}

{% step %}

### Submit your verification

Follow the prompts to:

* scan or photograph your document
* complete the selfie check

The verification platform confirms a successful submission.

![](https://146351401.fs1.hubspotusercontent-eu1.net/hubfs/146351401/image-png-Jan-07-2026-01-48-16-3289-PM.png)
{% endstep %}

{% step %}

### Confirm your status

Return to **Settings** in [app.proxidize.com](https://www.app.proxidize.com/).

Your identity status should show **Verified**.
{% endstep %}
{% endstepper %}

### Verification statuses

Review your status at any time in **Settings**.

| Status       | What it means                                             |
| ------------ | --------------------------------------------------------- |
| **Verify**   | Verification is incomplete. Click **Verify** to start.    |
| **Verified** | Your KYC verification was approved.                       |
| **Rejected** | The provider rejected your submission. Retry the process. |
| **Expired**  | You did not finish within 30 minutes. Start again.        |

### Need help?

If your verification repeatedly fails, contact support through live chat or at <support@proxidize.com>.

### Related articles

* [Verification for Proxidize Proxy Users](/getting-started/kyc-verification-for-proxidize-proxy-users)


# How to Request KYB Verification

Request KYB verification for eligible business use cases and website access.

Know Your Business (KYB) verification reviews your business and proxy use case.

KYB unlocks unlimited connection threads and may grant access to verification-gated categories.

KYB may grant access to financial websites and services, HR platforms, and feedback websites.\
KYB also provides a higher account-wide thread limit.

KYB does not enable additional proxy ports.

### When to request KYB

Request KYB when your business needs access to:

* financial websites or services
* HR and recruitment platforms
* consumer-review websites

KYC remains required for every customer. KYB is an additional review for eligible business use cases.

### Before you request KYB

Prepare:

* your exact proxy use case
* supporting business documents

We may request a short interview. This helps us understand your use case.

### Request KYB verification

Contact Proxidize Support through either channel:

* email <support@proxidize.com>
* use live chat

Include your proxy use case and supporting business documents. The team reviews each request internally and contacts you after the review.

{% hint style="info" %}
KYB approval applies only to approved website categories and use cases.
{% endhint %}

### What KYB does not change

These restrictions apply to both KYC and KYB customers:

* Adult-content websites remain blocked.
* Survey websites remain blocked.
* Government websites remain blocked.
* Military websites remain blocked.
* Ports other than `80` and `443` remain blocked.
* Government websites with `.gov` domains remain blocked.
* Military websites with `.mil` domains remain blocked.
* Survey-for-money websites remain blocked.
* Adult-content websites remain blocked.

Use of Proxidize proxies must remain within the approved use case.

### Thread limits

KYC customers have a limited number of concurrent threads across their accounts.

KYB customers receive unlimited connection threads after approval.

KYB customers receive a higher account-wide thread limit after approval.

### Related articles

* [Verification for Proxidize Proxy Users](/getting-started/kyc-verification-for-proxidize-proxy-users)
* [How to Complete KYC Verification](/getting-started/kyc-verification-for-proxidize-proxy-users/how-to-complete-kyc-verification)


# Overview

An overview about the different plans Proxidize offers, Including Mobile, Residential and the different access models.

This section covers how each product and access model works, how to authenticate and rotate, and the tools available to connect them. New to proxies? Start with [What are Proxidize Proxies](/getting-started/what-are-proxidize-proxies)?

{% hint style="warning" %}
Managed proxy traffic can only reach destination ports `80` and `443`.
{% endhint %}

### The Products

Proxidize offers two proxy products:

* **Mobile Proxies:** Real 4G/5G IPs from premium U.S. mobile ISPs: the most authentic, hardest-to-block IPs we offer. Available currently in the **United States only**. Best for ad verification, SEO, or any use case which benefits from Mobile IPs.
* **Residential Proxies:** Real residential-ISP IPs from a pool spanning **190+ countries**, sourced ethically and with consent. Best for global, geo-targeted work like scraping, monitoring, and research.

### Access Models

How you connect depends on the access model:

* **Per Proxy** (Mobile only): your own individually assigned proxies with full rotation control (rotate button, interval, or rotation URL). Best for long-running workflows.
* **Per GB** (Mobile and Residential): usage-based access to a our full IP pool through Access Points. You subscribe to a data package (from 25GB/Month) and change the session key to pull a new IP. Best for variable or large-scale work.

### The three managed plans

<table data-header-hidden="false" data-header-sticky data-search="false"><thead><tr><th>-</th><th>Mobile Per Proxy</th><th>Mobile Per GB</th><th>Residential Per GB</th></tr></thead><tbody><tr><td><strong>Network</strong></td><td>U.S. mobile ISPs (4G/5G)</td><td>U.S. mobile ISPs (4G/5G)</td><td>Residential ISPs, 190+ countries</td></tr><tr><td><strong>Access model</strong></td><td>Dedicated proxy, IPs might be shard on congestion.</td><td>Shared pool (Access Points)</td><td>Shared pool (Access Points)</td></tr><tr><td><strong>Coverage</strong></td><td>U.S., city-level</td><td>U.S., city-level</td><td>190+ countries, city + ISP</td></tr><tr><td><strong>Rotation</strong></td><td>Rotate button, interval, or rotation URL</td><td>Session-key change</td><td>Session-key change</td></tr><tr><td><strong>Data</strong></td><td>Unlimited, 50 GB fair-use per proxy</td><td>Pay per GB, no rollover</td><td>Pay per GB, rolls over</td></tr><tr><td><strong>Protocols</strong></td><td>HTTP, SOCKS5</td><td>HTTP, SOCKS5</td><td>HTTP, SOCKS5</td></tr><tr><td><strong>Best for</strong></td><td>Per-account, long-running workflows</td><td>Variable / large-scale mobile work</td><td>Global, geo-targeted work</td></tr></tbody></table>

### Choosing

* Not sure which product fits? See [Choose Between Mobile and Residential Proxies](/getting-started/choose-between-mobile-and-residential-proxies).
* Deciding between the two mobile access models? See Per Proxy vs Per GB.

### In this section

* [**Mobile Proxies**](/proxidize-proxies/mobile-proxies)**:** the U.S. mobile product, available Per Proxy or Per GB.
* [**Residential Proxies**](/proxidize-proxies/residential-pergb)**:** the global residential-ISP product, available Per GB.
* [**Per Proxy vs Per GB**](/proxidize-proxies/perproxy-vs-pergb)**:** how to choose your mobile access model.
* **Tools:**&#x20;
  * [the Proxidize Proxy Extension](/proxidize-proxies/proxidize-proxy-extension).
  * [the Proxidize API Overview](/proxidize-rest-api/proxidize-api).
  * [The Proxidize MCP server.](/proxidize-proxies/proxidize-mcp-server)

### Pricing

For current pricing, see the [**Mobile**](https://proxidize.com/proxy-server/mobile-proxies/#pricing-plans) and [**Residential**](https://proxidize.com/proxy-server/residential-proxies/#pricing-plans) pricing pages.


# perProxy vs perGB

Compare the Per Proxy and Per GB access models: dedicated proxies vs pay-as-you-go pool access to pick the right one.

Mobile Proxies come in two access models: **Per Proxy** and **Per GB**. (Residential is Per GB only.) This page explains the difference so you can pick the right one.

### Quick answer

* **Per Proxy:** gives you your own individually assigned proxies with full rotation control and a predictable monthly cost.
* **Per GB:** gives you usage-based access to the shared pool through Access Points, best for variable or large-scale work where you pay only for data.

***

### Side by side

<table data-header-hidden="false" data-header-sticky data-search="false"><thead><tr><th></th><th>Per Proxy</th><th>Per GB</th></tr></thead><tbody><tr><td><strong>What you get</strong></td><td>Proxies individually assigned to you, each on its own upstream device.</td><td>Access to the shared pool via unlimited Access Points</td></tr><tr><td><strong>Billing</strong></td><td>Per proxy, per month</td><td>Monthly data package (from 25 GB)</td></tr><tr><td><strong>Number of proxies</strong></td><td>The number you subscribe to</td><td>No cap. generate as many as you need from the pool. <em>see</em> <a href="/pages/Gljuqfhxy9h67WUk4aju"><em>session builder</em></a><em>.</em></td></tr><tr><td><strong>Rotation</strong></td><td>Rotate button, scheduled interval, or rotation URL</td><td>Change the session key to get a new IP, or use <em>Randomized</em> for an IP-per-request.</td></tr><tr><td><strong>Rotation URL / API rotate</strong></td><td>Yes</td><td>No</td></tr><tr><td><strong>Access Points</strong></td><td>No</td><td>Yes</td></tr><tr><td><strong>Analytics tab</strong></td><td>Yes</td><td>Yes</td></tr><tr><td><strong>Proxy pooling</strong></td><td>Yes (round-robin)</td><td>Yes</td></tr><tr><td><strong>Data</strong></td><td>Unlimited with a 50 GB fair-use threshold per proxy</td><td><p>Monthly data packages</p><ul><li>Mobile: no rollover</li><li>Residential: rolls over</li></ul></td></tr><tr><td><strong>Best for</strong></td><td>Predictable monthly costs, a consistent IP per task, and long-running sessions.</td><td><ul><li>Web scraping, </li><li>Automation, </li><li>Monthly packages plan that might change.</li></ul></td></tr></tbody></table>

{% hint style="warning" %}
The mobile **perProxy** proxies are pooled: each PerProxy proxy IP is dedicated to you the vast majority of the time, with a small chance of temporary sharing on congested locations. See [How Proxy Assignment Works on perProxy plans](/proxidize-proxies/mobile-proxies/mobile-per-proxy/how-proxy-assignment-works-on-per-proxy-plans).
{% endhint %}

***

### When to choose Per Proxy

Choose Per Proxy when you need predictable monthly costs and direct proxy control. You know your monthly expense upfront, rather than paying per GB as usage fluctuates. You also get a rotate button, scheduled rotation, and a rotation URL giving you full control over exactly when and how your IP changes.

### When to choose Per GB

Choose Per GB when your usage varies or you need to scale, and you'd rather subscribe to a data package than pay per proxy. You subscribe to a monthly data package (starting at 25 GB), create Access Points that all draw from that balance, and change the session key to pull a new IP. Need more data? Purchase an additional package.

Residential proxies also use the Per GB model.


# Mobile Proxies

How Proxidize Mobile Proxies work: real U.S. 4G/5G IPs, city targeting, ISPs, uptime, and the two plans.

Proxidize Mobile Proxies are built on a managed U.S. mobile network with infrastructure across 50+ U.S. locations, using real 4G/5G SIM cards from premium ISPs. They deliver the most authentic, hardest-to-block IPs Proxidize offers.

Mobile proxies are available in the **United States only**. For coverage in any other country, use [Residential Proxies](/proxidize-proxies/residential-pergb).

***

### What's IIncluded

* Real mobile IPs from premium U.S. ISPs
* City-level targeting across major U.S. cities
* HTTP and SOCKS5 proxies
* Instant delivery after purchase
* Near-100% uptime with automatic failover in under 30 seconds
* Browser-based management at [app.proxidize.com](https://app.proxidize.com)

### ISPs

Proxidize uses only premium U.S. mobile network operators, never resellers. You can pick an ISP at setup or change it anytime, and availability varies by location. The **Fastest** option automatically selects the best available ISP and is recommended.

***

### Two Access Models

<table data-view="cards"><thead><tr><th></th><th></th><th data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Per Proxy</strong></td><td>Individually assigned proxies with full rotation control (rotate button, interval, or rotation URL). Best for long-running work that needs a consistent IP.</td><td><a href="/pages/KTtTOdES6qtrUDcMr1s3">/pages/KTtTOdES6qtrUDcMr1s3</a></td></tr><tr><td><strong>Per GB</strong></td><td>a monthly data package (from 25 GB) with access to the shared mobile pool through Access Points. Best for variable or large-scale work</td><td><a href="/pages/WFzbiPgJjNpd98cwEYQv">/pages/WFzbiPgJjNpd98cwEYQv</a></td></tr></tbody></table>

Not sure which? See [Per Proxy vs Per GB.](/proxidize-proxies/perproxy-vs-pergb)

***

### Pricing

For current Mobile proxy pricing, see the [pricing page](https://proxidize.com/mobile-proxy-pricing/).


# Mobile - Per Proxy

Everything about the Mobile Per Proxy plan: individually assigned proxies, rotation, locations, ISPs, authentication, and controls.

The **Per Proxy** plan gives you SIM-based mobile proxies that are individually assigned to your account, each on its own upstream device and IP. You control location, ISP, and format per proxy. You also get complete control over how and when your IP changes, whether through the rotate button, scheduled rotation, or the rotation API/URL for programmatic control. Ideal for long-running campaigns that need consistent, hands-on control over your proxy setup.

> **Are my proxies dedicated only to me?**
>
> Our mobile proxies are pooled, because our infrastructure is designed around on-demand location switching. In practice they're dedicated to you the vast majority of the time, with a small chance of becoming shared temporarily on congested locations. Either way your credentials never change. See [How Proxy Assignment Works](/proxidize-proxies/mobile-proxies/mobile-per-proxy/how-proxy-assignment-works-on-per-proxy-plans).

***

### How assignment works

Each proxy runs on its own upstream device, and no two of your proxies share an upstream at the same time. Upstreams are pooled across locations (which is what lets you switch location and ISP on demand) rather than permanently assigned, so on congested locations there's a small chance of brief sharing between accounts. For the full explanation, see [How Proxy Assignment Works on Per Proxy Plans](/proxidize-proxies/mobile-proxies/mobile-per-proxy/how-proxy-assignment-works-on-per-proxy-plans).

### Data

Per Proxy includes **unlimited bandwidth with a 50 GB fair-use threshold per proxy per month**. Past 50 GB a proxy may be deprioritized (more affected by network conditions), but it's never cut off. For consistent heavy usage, add more proxies. Typical speeds are 5–25 Mbps (and can exceed 100 Mbps); a Speeds column updates every 6 hours.

### Getting your proxies

Next to each proxy you'll see a copy button for each protocol **HTTP** and **SOCKS5**. Press the one you want and the full proxy is copied to your clipboard in your chosen format:

* `IP:Port:Username:Password`
* `Username:Password@IP:Port`

Full setup help is in [Setting Up Your Proxidize Proxies](/getting-started/setting-up-your-proxidize-proxies).

### Rotation

You can rotate a proxy three ways. The IP changes while your credentials, location, and ISP preferences stay the same:

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td><strong>Rotate Button</strong></td><td>rotate a single proxy, or select several and bulk-rotate.</td><td><a href="/files/s1REqgn6wz1AvhkSq5O4">/files/s1REqgn6wz1AvhkSq5O4</a></td></tr><tr><td><strong>Rotation interval</strong></td><td>automatic schedule: 5 minutes, 1 hour, 8 hours, or Custom (minimum 1 minute). Set to "No interval" to disable.</td><td data-object-fit="cover"><a href="/files/eq3f630c0PxRJAyLY5iG">/files/eq3f630c0PxRJAyLY5iG</a></td></tr><tr><td><strong>Rotation URL</strong></td><td>a unique, API-callable URL per proxy you can trigger from any script.</td><td><a href="/files/MGUi5ETHO677NrUlnDqG">/files/MGUi5ETHO677NrUlnDqG</a></td></tr></tbody></table>

If you don't rotate, the ISP may still reassign the IP periodically (typically every 1–4 hours). This is normal as your credentials stay valid and nothing needs updating.

***

### Authentication

* **User / Pass** (default): Each proxy has credentials; resetting the password updates all proxies at once (letters and numbers only).
* **IP Whitelist:** Authenticate by approved public IP instead of credentials, managed via the IP Allowlist.

You can switch between both modes directly from the toolbar.

#### Setting Up IP Whitelisting

When IP Whitelist is selected, click the **IP Allowlist** button in the toolbar to open the management modal. From there you can:

* Add a single IP address manually
* Add multiple IP addresses at once
* Use the **Add My IP** helper to automatically detect and add your current public IP
* Remove or manage existing IP entries
* Track the total number of IPs currently allowed

![IP Whitelist window](/files/d721b765a72612c156ce47217da5a3a480607145)

Once your IPs are added, any request originating from a whitelisted address will be authenticated automatically, no username or password required.

{% hint style="warning" %}
IP Whitelisting authenticates by source IP only. If your public IP changes (e.g. due to a network switch or ISP reassignment), access will stop working until the new IP is added to the allowlist.

**Port Mapping restriction:** When using IP Whitelist authentication, only Dynamic port assignment is supported. Static port mapping is not available in this mode. See [Port Mapping](#port-mapping) for details.
{% endhint %}

All existing proxy settings, including location, ISP, rotation interval, and hostname type, continue to work as normal regardless of which authentication mode is active.

***

### Port Mapping

Control how ports are assigned to your proxies using the **Port Mapping** dropdown in the dashboard toolbar.\
Port mapping does not affect performance; it exists so your proxy list can meet the formatting rules some tools require (for example, that no two proxies share the same port).

![Port Mapping Dropdown Menu](/files/82383bc13bc4158b0b80309ccac5188012751319)

#### Two modes are available:

* **Static:** Ports are fixed and do not change between sessions. 20000 for HTTP and 20002 for SOCKS
* **Dynamic.** Each proxy is assigned its own unique HTTP and SOCKS port automatically, with no overlap. Ports follow a standardized order, which makes them easier to scan, cross-reference, and validate across your proxy list:

| Protocol | Range         | Order      |
| -------- | ------------- | ---------- |
| HTTP     | 18000 → 20000 | Descending |
| SOCKS    | 20002 → 22002 | Ascending  |

{% hint style="info" %}
Dynamic is recommended for most setups. The predictable port ordering makes it straightforward to cross-reference proxies in bulk exports or scripts.
{% endhint %}

***

### Other controls

* **Hostname type:** IP (direct) or DNS (dynamic domain).
* **Proxy tags:** up to 20 tags per proxy for organizing and filtering. Especially useful for grouping proxies by purpose, location, or any custom category that fits your workflow.
* **Proxy format:** choose either output format above.
* **Create User:** add sub-users (see [Adding Sub-Accounts](/account-and-billing/account-management/adding-sub-accounts-in-the-proxidize-dashboard)).

***

### Related

* [How Proxy Assignment Works on Per Proxy Plans](/proxidize-proxies/mobile-proxies/mobile-per-proxy/how-proxy-assignment-works-on-per-proxy-plans)
* [Per Proxy Pooling](/proxidize-proxies/mobile-proxies/mobile-per-proxy/per-proxy-pooling)
* [Per Proxy vs Per GB](/proxidize-proxies/perproxy-vs-pergb)
* [Proxidize API](/proxidize-rest-api/proxidize-api)

***

### Need Help?

If you have any questions, concerns, or need further clarification, feel free to reach out to us via live chat or email us directly at <support@proxidize.com>.


# Per Proxy - Pooling

Combine all your Per Proxy proxies into one round-robin endpoint with shared credentials and sticky or random modes.

Learn how to use Pooling to distribute traffic across multiple mobile proxies using a single endpoint.

Proxy Pooling allows you to combine multiple mobile proxies into one single proxy endpoint.

Instead of connecting to each proxy individually, your traffic is automatically distributed across all available proxies in the pool. Proxy Pooling is available for Per-Proxy plans and supports both HTTP and SOCKS5 proxies.

You can access pooling at [app.proxidize.com/proxies/mobile/pooling/](https://app.proxidize.com/proxies/mobile/pooling/).

## How Proxy Pooling Works

* All active proxies are grouped into a shared pool
* All proxies in the pool use the same username and password
* Traffic is evenly distributed across all available proxies

## Proxy Assignment Logic

* Each new request is sent to the next available proxy in the pool
* Proxies are used sequentially to ensure even distribution
* If a proxy becomes unavailable (expired, removed, or downgraded), it is immediately excluded from the pool and no longer receives traffic
* The behavior of the pool depends on the total number of active proxies available

## Stickiness

Proxy Pooling allows you to control how requests are routed using stickiness.

### Randomize IP

* Each request is routed through a different proxy/IP
* Uses round-robin rotation by default
* Best for scraping, automation, and high-volume requests

> **Note:** Randomize IP does not use sessions.

### Sticky IP

* Requests stay on the same proxy/IP for the duration of the session
* If the number of sessions exceeds the number of available proxies in your plan, IPs will be duplicated because sessions cycle back to the first proxy and continue the round-robin assignment.
* You have the option to refresh the session ID. This will generate new proxy credentials, refresh the proxy, which then maintains a static IP address.
* Best for logins, account-based workflows, or longer sessions

> **Note:** Sticky IP requires a session identifier added after `-p-default`.

![](/files/81ccf788dd7c626f6037b2d20995efebdf21df7c)

![](/files/4c408bfcf375677ee9dd8a57ccb18d0c75ba2247)

## Proxy Pool Test Example

Use the following command to test the proxy pool using Sticky IP or Randomize IP behavior.\
The command sends 10 requests through the same proxy endpoint and returns the IP address used for each request.

* **Sticky IP:** All requests return the same IP
* **Randomize IP:** Each request returns a different IP from the available pool

Command

```bash
proxy="ip:port:username:password"

host=$(echo "$proxy" | cut -d: -f1)

port=$(echo "$proxy" | cut -d: -f2)

user=$(echo "$proxy" | cut -d: -f3)

pass=$(echo "$proxy" | cut -d: -f4)

echo "Test IPs  :"

echo "$proxy"

echo "----------------------------------------"


for i in {1..10}; do

  ip=$(curl -s --max-time 20 --proxy "http://$user:$pass@$host:$port" https://api.ipify.org || echo "FAILED")

  echo "Request $i -> $ip"

  sleep 1

done
```

Replace `ip:port:username:password` with your actual proxy credentials from the dashboard.

Output:

```
Test IPs:

ip:port:username:password

----------------------------------------

Request 1 -> 34.123.45.67

Request 2 -> 34.123.45.89

Request 3 -> 34.123.45.102

Request 4 -> 34.123.45.67

Request 5 -> 34.123.45.131

...

Request 10 -> 34.123.45.77
```

This confirms that each request is routed through a different proxy if Randomize IP is being used, and all requests are routed to the same proxy in case of using Sticky IP

## Hostname Type Selection

Control how your proxies are resolved:

* IP Hostname: Direct IP
* DNS Hostname: Dynamic domain

![](/files/dfdc4c23664e75ad4f5f363ca2c79ab149ff11d5)

## Live Proxy Credential Generation

Proxidize automatically generates proxy credentials in real time, allowing you to access your mobile proxies immediately after setup — no manual configuration required.

Each proxy comes with the following connection details:

* Host (IP or DNS): The IP address or domain name assigned to your proxy.
* Port: The unique port number corresponding to the specific proxy.
* Username: A system-generated username used for authentication.
* Password: Secure, customizable password for enhanced access control.

These credentials can be used directly in your proxy client, browser, or third-party tools that support HTTP(S) or SOCKS5 protocols.

![](/files/20cb57f8f37932d235de113b1fdf49860c18f49e)

## Basic cURL Example (Auto-Generated)

To help you test your proxy setup instantly, Proxidize displays a pre-filled CURL command based on your selected protocol (HTTP or SOCKS5). This command includes your proxy host, port, and credentials, making it easy to verify functionality from the command line.

You can:

* Copy and paste the command into your terminal for quick testing.
* Switch protocols to auto-generate a cURL snippet that matches your chosen settings.
* Use the example as a template when integrating proxies into scripts or tools.

This feature is especially useful for troubleshooting or verifying proxy connectivity without needing additional software.

![](/files/5cd66ea390fe0ef71e9606d7fbb85649b7505f27)

## Formatted Proxy List Generator

Export your proxies in your preferred format:

* `hostname:port:username:password`
* `username:password@hostname:port`

Choose from batch sizes of 10, 20, 50, or 100 proxies—and generate unlimited lists as needed.

![](/files/7c155515b77159b20204e5a65fddf0a09a92ca77)

![](/files/2195342aa95ecdbd5d518bd9a5b6b9eaa01e16bc)

## Port Mapping

Port Mapping lets you control how ports are assigned to your proxy list. You can use the same port for all proxies or assign unique ports to each proxy.

**Static**\
Uses the same port for all proxies.\
HTTP: `20000`\
SOCKS5: `20002`

**Dynamic**\
Each proxy is assigned its own HTTP and SOCKS5 ports, which are shown on the dashboard. Port ordering is standardized for easier review.\
HTTP range: `18000` → `20000`\
SOCKS5 range: `20002` → `22002`

![](/files/a593301c47ba2b229dc32442fbe1c4ff656f2d65)

## Where to Manage Proxy Pooling

You can configure and access Proxy Pooling from your dashboard:

👉 <https://www.app.proxidize.com/proxies/mobile/pooling/>

From there, you can:

* Choose HTTP or SOCKS5
* Set stickiness behavior
* View pool credentials
* Copy ready-to-use proxy connection details


# How Proxy Assignment Works on Per Proxy Plans

See how proxies are assigned on Per Proxy plans and what affects assignment behavior.

This article explains how Proxy Assignment works and what to expect during rotation and device switching.

On Proxidize Per Proxy plans, each proxy is assigned to an upstream device, and routed based on the location and ISP filters you set.

### **One Proxy Per Device**

Each proxy on a Per Proxy plan is routed through its own upstream device. No two proxies within your own account will share the same upstream device at the same time. This means that across your own proxy pool, each proxy operates on a distinct upstream and your proxies will never overlap or interfere with each other.

When you rotate, your proxy moves to a different upstream device and receives a new IP. This switch happens on the backend, so nothing changes on your side. Your credentials, tools, and integrations continue to work exactly as before.

Because our infrastructure is built around location switching, upstream devices are pooled across locations rather than permanently assigned to a single account. This is what allows you to switch locations and ISPs on demand. Your proxy is on its own dedicated upstream device the vast majority of the time, though on busy or congested locations there is a small chance of temporary sharing between accounts.

One important detail is that mobile ISPs use Carrier-Grade NAT (CGNAT) to manage their public IP pools. This is standard practice across mobile networks. As a result, even when two proxies are running on completely separate upstream devices, they may occasionally exit through the same public IP depending on ISP-level conditions. This behavior is not specific to Proxidize. It is a normal characteristic of how mobile networks operate globally and is outside of our control.

### **Setting Your Filters**

Each proxy can be configured with two filters that determine which upstream device it routes through:

* **Location:** Choose a specific U.S. city (*e.g. Chicago, Dallas, Los Angeles*) or select **Fastest** to automatically route through the best performing available location.
* **ISP:** Choose a specific mobile ISP (*Purple, Blue, or Red Network*) or select **Fastest** to automatically use the best available ISP.

You can set these filters at any time from your proxy dashboard. Once saved, Proxidize will route your proxy traffic to match your selected city and ISP.

### **Your Credentials Never Change**

When your filters are applied or your proxy rotates, what changes is the **upstream device** your traffic is routed through, not your proxy credentials.

Your **hostname**, **port**, **username**, and **password** all stay exactly the same. You don't need to update any tools, scripts, or integrations. Everything continues to work as before, just routing through a new IP on the backend.

### **What Happens If Your Selected Location or ISP Is Unavailable**

Unavailable locations and ISPs are greyed out in the dashboard and cannot be selected. If a location or ISP you're currently using becomes unavailable, your proxy will automatically reroute to another upstream device, either within the same location if possible, or a different location if not. Service continues without any action required on your end.

#### **Summary**

| What changes on rotation | What stays the same     |
| ------------------------ | ----------------------- |
| Upstream device          | Your proxy credentials  |
| IP address               | Your filter preferences |


# Mobile - PerGB

Everything about the Mobile Per GB plan: Access Points, authentication, session keys, targeting, port mapping, and analytics.

The **Mobile Per GB** plan is a monthly subscription to a data package that gives you access to Proxidize's shared U.S. mobile pool.\
Instead of paying per proxy, you choose a data package and use it across as many proxies as you like. It's ideal for variable workloads, short-term campaigns, and large-scale scraping and automation.

Mobile proxies are U.S. only. Available package sizes run from 50 GB up to 20,000 GB. Per GB and data does **not** roll over. Your package is to be used within its billing period.

To change your data, you manage your package subscriptions: subscribe to an additional package to add more, or cancel a package to reduce (your remaining GB stays available until that package's billing period ends). Each package is its own subscription with its own billing date.

***

### Access Points

You work with Per GB through **Access Points**: independent proxy configurations that all draw from the same data balance. You can create unlimited Access Points and delete them anytime (a deleted name can't be reused).

Each Access Point has its own:

* Protocol (HTTP or SOCKS5)
* Hostname type (IP or DNS)
* IP mode (Sticky or Randomize)
* Location (city or Random City)
* Authentication method (see below)

<figure><img src="/files/DWQ0EyRCZqoppBWADlIs" alt="" width="375"><figcaption></figcaption></figure>

#### Authentication

When creating an Access Point, you'll choose how it authenticates, either via **User / Pass (Named)** or **IP Whitelist**.

* **User / Pass:** enter an Access Point name (letters, numbers, and underscores only); credentials are generated automatically.
* **IP Whitelist:** authenticate by approved public IP. Each whitelisted IP creates one dedicated Access Point, with its configuration (protocol, hostname, IP mode, location) set at creation. If your public IP changes, add the new one or access stops.

**IP Whitelist Configuration**

IP Whitelist Access Points include a **Configuration** section where you can set the following options directly at creation:

* **Proxy Type:** HTTP or SOCKS5
* **Hostname:** IP or DNS
* **IP Mode:** Random or Sticky
* **Location**

<figure><img src="/files/5gu9MIUz2OyxEPDtJN4x" alt="" width="375"><figcaption></figcaption></figure>

These settings apply specifically to the IP Whitelist Access Point and determine how proxy traffic is routed for requests originating from your whitelisted IPs.

{% hint style="warning" %}
**Note:** IP Whitelisting authenticates based on your source public IP address. If your public IP changes (e.g. due to ISP reassignment, VPN usage, or network changes), access will stop working until the new IP is added to the allowlist. For frequently changing IP environments, User/Pass may be more reliable.
{% endhint %}

***

### Getting your proxies

All of your proxies are listed together under the **Formatted Proxy List** section of the dashboard. There, you'll be able to see every proxy in one place, choose your protocol and format, and copy them individually or export in bulk (batches of 10, 20, 50, or 100). Formats:

* `IP:Port:Username:Password`
* `Username:Password@IP:Port`

To build a mixed list with different settings per batch (country, city, ISP, protocol, stickiness, Access Point), use the [Session Builder](/proxidize-proxies/pergb-session-builder) and export it all as one list.

***

### Changing your IP

Per GB has no rotate button and no rotation URL. To get a new IP, change the **session key** in your credentials, or select a different proxy from the pool. Use **Refresh Session IDs** to regenerate all session credentials at once.

* **Sticky IP:** the same IP for the duration of a session, identified by a session key. Mobile sticky IPs are ISP-controlled and typically hold \~1–4 hours.
* **Randomize IP:** a new IP on every request; best for scraping and high-volume automation.

### Generating additional proxies

Per GB gives access to the full pool, so there's no fixed proxy count. In **Sticky IP** mode, the username contains a session segment in the format `-s-<10-character token>`. Change that token to any other value to get a different proxy from the pool. You can script this to build large proxy lists automatically.

***

### Targeting

City-level targeting across major U.S. cities, with all locations accessible at once via separate Access Points. Use **Random City** to rotate across available U.S. cities. ISP selection works the same as elsewhere on Mobile, choose an ISP or select **Fastest**.

***

### Port mapping

Control how ports are assigned to your proxies using the **Port Mapping** dropdown in the dashboard toolbar.

Two modes are available:

* **Static:** Ports are fixed and do not change between sessions.
* **Dynamic:** Each proxy is assigned a dedicated HTTP and SOCKS port automatically. Ports follow a standardized order, making them easier to scan and validate across your proxy list.

![Dynamic Port Dropdown Menu](/files/73056a10d203c0c93e6e9bf1cd71de96e95c22cb)

**Dynamic Port Ranges**

| Protocol | Range         | Order      |
| -------- | ------------- | ---------- |
| HTTP     | 18000 → 20000 | Descending |
| SOCKS    | 20002 → 22002 | Ascending  |

With Dynamic mode, every proxy gets its own unique port for both HTTP and SOCKS, no overlap, no ambiguity.

{% hint style="info" %}
Dynamic is recommended for most setups. The predictable port ordering makes it straightforward to cross-reference proxies in bulk exports or scripts.
{% endhint %}

***

## Basic cURL Example (Auto-Generated)

To help you test your proxy setup instantly, Proxidize displays a pre-filled CURL command based on your selected protocol (HTTP or SOCKS5). This command includes your proxy host, port, and credentials, making it easy to verify functionality from the command line.

**You can:**

* Copy and paste the command into your terminal for quick testing.
* Switch protocols to auto-generate a cURL snippet that matches your chosen settings.
* Use the example as a template when integrating proxies into scripts or tools.

This feature is especially useful for troubleshooting or verifying proxy connectivity without needing additional software.

<img src="/files/5cd66ea390fe0ef71e9606d7fbb85649b7505f27" alt="" width="563">

***

### Related

* [Per Proxy vs Per GB](/proxidize-proxies/perproxy-vs-pergb)
* [Residential Proxies (also Per GB)](/proxidize-proxies/residential-pergb)
* [Setting Up Your Proxidize Proxies](/getting-started/setting-up-your-proxidize-proxies)
* [Proxidize API](/proxidize-rest-api/proxidize-api)
* [Upgrade or Downgrade your subscriptions](/account-and-billing/billing-and-subscriptions/how-to-upgrade-downgrade-or-change-your-subscription)

***

### Need Help?

If you have any questions, concerns, or need further clarification, feel free to reach out to us via live chat or email us directly at <support@proxidize.com>.


# Residential - perGB

How Proxidize Residential Proxies work: 190+ countries, city and ISP targeting, rollover data, Access Points, and IP behavior.

Proxidize Residential Proxies use residential-ISP IP addresses from a globally distributed pool, sourced ethically and with consent through Proxidize's bandwidth-sharing app and partner apps.

They're the product to use for coverage anywhere outside the United States, and they're built for scalable, geo-targeted work like scraping, monitoring, and research.

Residential is offered on the **Per GB** model only. You subscribe to a monthly data package (from 25 GB), and all your Access Points draw from that shared balance. Unused data rolls over.

***

### What's Included

* Real residential-ISP IPs across **190+ countries**
* City-level and ISP-level targeting
* Unused-data rollover
* High concurrency
* HTTP, and SOCKS5 proxies
* Real-time analytics

***

### Coverage and targeting

* **190+ countries**, with city-level and ISP-level targeting.
* **ISP selection:** available ISPs are listed dynamically based on the country and city you choose. Pick a specific ISP, or choose **Random** to rotate across all available ISPs.
* Use **Random City** to rotate within a country, or select a specific city for precise targeting.

***

### Pricing

For current Residential proxy pricing, see the [pricing page](https://proxidize.com/proxy-server/residential-proxies/#pricing-plans).

***

### Access Points

You work with Per GB through **Access Points**: independent proxy configurations that all draw from the same data balance. You can create unlimited Access Points and delete them anytime (a deleted name can't be reused).

Each Access Point has its own:

* Protocol (HTTP or SOCKS5)
* Hostname type (IP or DNS)
* IP mode (Sticky or Randomize)
* Location (city or Random City)
* Authentication method (see below)

<figure><img src="/files/DWQ0EyRCZqoppBWADlIs" alt="" width="375"><figcaption></figcaption></figure>

#### Authentication

When creating an Access Point, you'll choose how it authenticates, either via **User / Pass (Named)** or **IP Whitelist**.

* **User / Pass:** enter an Access Point name (letters, numbers, and underscores only); credentials are generated automatically.
* **IP Whitelist:** authenticate by approved public IP. Each whitelisted IP creates one dedicated Access Point, with its configuration (protocol, hostname, IP mode, location) set at creation. If your public IP changes, add the new one or access stops.

**IP Whitelist Configuration**

IP Whitelist Access Points include a **Configuration** section where you can set the following options directly at creation:

* **Proxy Type:** HTTP or SOCKS5
* **Hostname:** IP or DNS
* **IP Mode:** Random or Sticky
* **Location**

<figure><img src="/files/5gu9MIUz2OyxEPDtJN4x" alt="" width="375"><figcaption></figcaption></figure>

These settings apply specifically to the IP Whitelist Access Point and determine how proxy traffic is routed for requests originating from your whitelisted IPs.

{% hint style="warning" %}
**Note:** IP Whitelisting authenticates based on your source public IP address. If your public IP changes (e.g. due to ISP reassignment, VPN usage, or network changes), access will stop working until the new IP is added to the allowlist. For frequently changing IP environments, User/Pass may be more reliable.
{% endhint %}

***

### Getting your proxies

All of your proxies are listed together under the **Formatted Proxy List** section of the dashboard. There, you'll be able to see every proxy in one place, choose your protocol and format, and copy them individually or export in bulk (batches of 10, 20, 50, or 100). Formats:

* `IP:Port:Username:Password`
* `Username:Password@IP:Port`

To build a mixed list with different settings per batch (country, city, ISP, protocol, stickiness, Access Point), use the [Session Builder](/proxidize-proxies/pergb-session-builder) and export it all as one list.

***

### Changing your IP

Per GB has no rotate button and no rotation URL. To get a new IP, change the **session key** in your credentials, or select a different proxy from the pool. Use **Refresh Session IDs** to regenerate all session credentials at once.

* **Sticky IP:** the same IP for the duration of a session, identified by a session key. Mobile sticky IPs are carrier-controlled and typically hold \~1–4 hours.
* **Randomize IP:** a new IP on every request; best for scraping and high-volume automation.

***

### Getting started

1. Choose a bandwidth package and subscribe.
2. Create an Access Point and select your location (country, city, ISP).
3. Choose Sticky or Randomize IP mode.
4. Copy your credentials from the Formatted Proxy List into your tool or script.

Full connection help is in [Setting Up Your Proxidize Proxies](/getting-started/setting-up-your-proxidize-proxies).

***

### Related

* [Choose Between Mobile and Residential Proxies](/getting-started/choose-between-mobile-and-residential-proxies)
* [Per Proxy vs Per GB](/proxidize-proxies/perproxy-vs-pergb)
* [Upgrade or downgrade your subscription](/account-and-billing/billing-and-subscriptions/how-to-upgrade-downgrade-or-change-your-subscription)

***

### Need Help?

If you have any questions, concerns, or need further clarification, feel free to reach out to us via live chat or email us directly at <support@proxidize.com>.


# perGB - Session Builder

Generate a custom, mixed Per GB proxy list by stacking sessions with different countries, protocols, stickiness, and Access Points, then export them all at once.

Session Builder is a tool on your Per GB dashboard (available for both Mobile and Residential) that lets you generate a **custom, mixed proxy list** in one place. Instead of a single set of settings, you stack multiple **sessions,** each its own batch of proxies with its own configuration, then export them all as one formatted list.

You'll find it on the **Session Builder** tab of your Per GB product, next to *Access Point* and *Buy*.

<figure><img src="/files/5Ia3A2IhtifyVrbGvbSX" alt=""><figcaption></figcaption></figure>

***

### How it works

{% stepper %}
{% step %}

### **Configure a session**.&#x20;

Set the values for one batch of proxies:

* **Access Point:** which Access Point the proxies use (a default is preselected; pick another from the dropdown if you like)
* **Type:** HTTP or SOCKS5
* **Country / City targeting**: Residential supports country, city, and ISP across 190+ countries; Mobile targeting stays within the United States.
* **Carrier/ISP:** choose a carrier for Mobile or ISP for Residential.
* **Stickiness:** Randomize IP or Sticky IP
* **Hostname:** DNS or IP
* **Count:** how many proxies in this batch (up to 10,000)

<figure><img src="/files/YLGsrDTJd63qYGvbVwn9" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}

### Click "Add \[N] proxies" to drop the batch into your list.

<figure><img src="/files/Id5GZFnwmw9zOjdyDKhO" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Repeat with different settings to mix and match.&#x20;

Each batch appears as a session row showing its count, Access Point, location, and settings. You can duplicate, delete, or clear rows.

{% endstep %}

{% step %}

### Copy the generated proxies&#x20;

The bottom shows every proxy you've added. Choose your output format (for example \``hostname:port:username:password`\`) and Static or Dynamic ports, then copy the list.
{% endstep %}
{% endstepper %}

***

### Good to know

* **Nothing is saved.** Session Builder builds a list in your browser, it doesn't store the proxies on your account. Set your values, add, and copy.
* **Building uses no data.** Generating and exporting proxies doesn't touch your GB balance; data is only consumed when you send traffic through the proxies.
* **Mix and match freely.** Different sessions can use different countries, cities, protocols, stickiness, and Access Points. Ideal for building one diverse list in a single list (for example, 10 U.S. HTTP proxies + 5 city-targeted proxies + 5 SOCKS5 proxies).

***

### Related

* [Mobile Per GB](/proxidize-proxies/mobile-proxies/mobile-pergb)
* [Residential Proxies](/proxidize-proxies/residential-pergb)
* [Setting Up Your Proxidize Proxies](/getting-started/setting-up-your-proxidize-proxies)

***

### Need Help?

If you have any questions, concerns, or need further clarification, feel free to reach out to us via live chat or email us directly at <support@proxidize.com>.


# Proxidize Proxy Extension

Use the Proxidize Proxy Extension to connect, manage, and test proxy sessions in your browser.

Learn how to use the Proxidize Proxy Extension to add, test, manage, and switch between proxies directly from your browser.

## What Is the Proxidize Proxy Extension?

The Proxidize Proxy Extension is a browser extension that makes it easier to connect to proxies without manually changing your browser or operating system proxy settings.

It works similarly to proxy management extensions such as FoxyProxy, but is designed to be more straightforward for Proxidize users.

With the extension, you can:

* Add one proxy manually.
* Add multiple proxies at once by pasting them in bulk.
* Import proxies from a CSV file.
* Test proxies before connecting.
* Switch between proxies with one click.
* Search and filter saved proxies.
* View useful proxy details such as country, type, endpoint, authentication, and egress IP.

## Install the Extension

Install the Proxidize Proxy Extension for your browser:

[![Proxidize Chrome extension Link](/files/1054e613384bb0ceae7e705489094c10f2bf3e75)](https://chromewebstore.google.com/detail/proxidize-proxy-extension/gccdbcipcjgfnjlegofdhflkifgkdmpb?hl=en)[![Proxidize chrome extension URL](/files/5023aeb23ff7b725e9f81562a7bae59cd1e00fe2)](https://addons.mozilla.org/en-US/firefox/addon/proxidize-proxy-extension/)

### Browser and Proxy Type Support

Proxy type support depends on the browser you are using.

| Browser | HTTP With Username/Password | SOCKS With Username/Password | SOCKS With IP Whitelisting |
| ------- | --------------------------- | ---------------------------- | -------------------------- |
| Firefox | Supported                   | Supported                    | Supported                  |
| Chrome  | Supported                   | Not supported                | Supported                  |

{% hint style="warning" %}
On Chrome, SOCKS proxies are supported only when using IP whitelisting. SOCKS proxies with username and password authentication are not supported through the Chrome extension flow.
{% endhint %}

If you need to use SOCKS proxies on Chrome, configure IP whitelisting from the relevant subscription article:

* [Mobile - PerGB](/proxidize-proxies/mobile-proxies/mobile-pergb)
* [Mobile - Per Proxy](/proxidize-proxies/mobile-proxies/mobile-per-proxy)
* [Residential Proxies](/proxidize-proxies/residential-pergb)

### Open the Extension

After installing the extension:

1. Click the Proxidize icon in your browser toolbar.
2. The extension window will open.

### Add Proxies

Click **Add proxies** to open the import window.

![](/files/7b179ef043d4166cffab7ddb29b850359c639c67)

You can add proxies in three ways:

* Paste one proxy manually.
* Paste multiple proxies in bulk.
* Upload a CSV file.

## Test Proxies Before Connecting

After adding proxies, you can test them before connecting.

**To test a proxy:**

1. Select the proxy from the list.
2. Click **Test** or the test icon.
3. Wait for the test to complete.

![](/files/5220358aacbbdc6d2fd03c01b7b85bb409a5c035)

Testing helps confirm whether the proxy is reachable and whether the authentication works.

The extension can also detect useful information such as:

* Proxy country.
* Egress IP.
* Proxy reachability.
* Authentication status.

## Connect to a Proxy

To connect:

1. Find the proxy you want to use.
2. Click the connect action.
3. Confirm the status changes to **Connected**.

![](/files/f0834fa7cf118cfaf64bfc31c3927d09af476515)\
Once connected, browser traffic will route through the selected proxy.

To disconnect, click the connected status or disconnect action.

## Search and Filter Proxies

Use the search bar to find proxies by:

* Nickname.
* Host.
* Country.
* Type.

This is useful when you have many proxies saved in the extension.

## Manage Saved Proxies

From the proxy table, you can review:

* Name.
* Country.
* Type.
* Endpoint.
* Authentication.
* Egress IP.
* Available actions.

You can also delete proxies you no longer need.

## When to Use the Extension

Use the Proxidize Proxy Extension when you want to:

* Quickly switch between multiple proxies.
* Avoid manually editing browser or operating system proxy settings.
* Test proxies before using them.
* Manage a large list of proxies in one place.
* Import proxies in bulk instead of adding them one by one.

## Troubleshooting

| Issue                                        | What to Check                                                                                            |
| -------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| HTTP proxy does not connect                  | Confirm the host, port, username, and password are correct.                                              |
| SOCKS proxy does not work on Chrome          | Chrome supports SOCKS only with IP whitelisting. Use Firefox for SOCKS username/password authentication. |
| SOCKS proxy with username/password is needed | Use Firefox, which supports SOCKS proxies with username/password.                                        |
| Proxy test fails                             | Confirm the proxy is active, credentials are correct, and your subscription is active.                   |
| Egress IP does not show                      | Test the proxy again and confirm the proxy is reachable.                                                 |
| Imported proxies look incorrect              | Check the proxy format or CSV formatting before importing again.                                         |
| Website still shows your original IP         | Confirm the extension status shows Connected and retest the proxy.                                       |

## Need Help?

If you have any questions, concerns, or need further clarification, feel free to reach out to us via live chat or email us directly at <support@proxidize.com>.


# Proxidize MCP Server

Connect supported AI clients to Proxidize through the Model Context Protocol (MCP).

Manage mobile and residential proxies from any MCP-compatible AI client.

Rotate IPs, monitor usage, manage tags, and control access through natural language.

The server checks your active subscriptions when it starts. It loads only tools available to your account.

## Requirements

You need Node.js 18 or later and a Proxidize API token.

To get your token:

1. Sign in to the Proxidize Dashboard.
2. Select your avatar, then select **Settings**.
3. Copy your API token.

{% hint style="warning" %}
Keep your API token private. Do not commit it to version control.
{% endhint %}

## Connect a client

{% tabs %}
{% tab title="Claude Code" %}
Use the local scope for the current project:

```bash
claude mcp add proxidize -e PROXIDIZE_API_TOKEN=YOUR_API_TOKEN -- npx -y @proxidize/mcp
```

Use the user scope for every local project:

```bash
claude mcp add proxidize --scope user -e PROXIDIZE_API_TOKEN=YOUR_API_TOKEN -- npx -y @proxidize/mcp
```

For shared projects, configure the token through secret management:

```bash
claude mcp add --scope project proxidize -- npx -y @proxidize/mcp
```

Run `/mcp` to verify the connection.
{% endtab %}

{% tab title="Claude Desktop" %}
Add this configuration to `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "proxidize": {
      "command": "npx",
      "args": ["-y", "@proxidize/mcp"],
      "env": {
        "PROXIDIZE_API_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}
```

{% endtab %}

{% tab title="Cursor, Windsurf, or VS Code" %}
Add this configuration to `.mcp.json` or your IDE's MCP settings:

```json
{
  "mcpServers": {
    "proxidize": {
      "command": "npx",
      "args": ["-y", "@proxidize/mcp"],
      "env": {
        "PROXIDIZE_API_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}
```

{% endtab %}
{% endtabs %}

## Available tools

Every installation provides these account tools:

* `get_subscription` lists active subscriptions.
* `get_outbound_ip` returns the server's public IP.

The server loads subscription-specific tools automatically.

<details>

<summary>Per Proxy Mobile</summary>

Manage dedicated mobile proxies with tools to:

* List and inspect proxies, locations, ISPs, and tags.
* Rotate IPs and configure automatic rotation.
* Manage passwords, IP allowlists, and proxy tags.

</details>

<details>

<summary>Per GB Mobile and Residential</summary>

Each plan provides plan-prefixed tools:

* Check usage, locations, ISPs, and access point settings.
* Create access points and IP allowlist entries.
* Update allowlist entries and access point routing.

Mobile tools start with `mobile_`. Residential tools start with `residential_`.

</details>

<details>

<summary>Analytics</summary>

Any active plan enables analytics tools:

* `get_traffic_analytics` returns bandwidth and request trends.
* `get_top_domains` lists destinations by usage or request count.
* `get_connection_history` returns per-request connection logs.

</details>

## Configuration

| Variable                      | Required | Default                            | Purpose                                          |
| ----------------------------- | -------- | ---------------------------------- | ------------------------------------------------ |
| `PROXIDIZE_API_TOKEN`         | Yes      | —                                  | API token for your Proxidize account.            |
| `PROXIDIZE_BASE_URL`          | No       | `https://api.proxidize.com/api/v1` | API base URL.                                    |
| `PROXIDIZE_PROXY_HOST`        | No       | `pg.proxi.es`                      | Proxy gateway host for connection URLs.          |
| `PROXIDIZE_TIMEOUT`           | No       | `30000`                            | Request timeout in milliseconds.                 |
| `PROXIDIZE_MAX_RETRIES`       | No       | `2`                                | Server-error retries, from `0` to `5`.           |
| `PROXIDIZE_DISABLE_ANALYTICS` | No       | —                                  | Set to `1` to disable anonymous usage analytics. |

The server collects anonymous tool, latency, and error data by default. It never sends tool responses. Sensitive parameters are redacted.

Set `PROXIDIZE_DISABLE_ANALYTICS=1` or `DO_NOT_TRACK=1` to opt out.

## Troubleshooting

| Issue                             | Resolution                                                           |
| --------------------------------- | -------------------------------------------------------------------- |
| `PROXIDIZE_API_TOKEN is required` | Add the token to your MCP client configuration.                      |
| Only account tools appear         | Confirm your token and active subscription.                          |
| `HTTP 401: Invalid token`         | Generate a new token in **Settings**, then update the configuration. |
| Requests time out                 | Set `PROXIDIZE_TIMEOUT=60000` in the server environment.             |

## FAQ

<details>

<summary>What is the Proxidize MCP Server?</summary>

It gives AI agents direct access to your Proxidize account. Use natural language to rotate IPs, change locations, check usage, and manage access points.

</details>

<details>

<summary>Is it free to use?</summary>

The MCP Server is free and open source under the MIT License. You need an active Proxidize subscription to use proxy-management tools.

</details>

<details>

<summary>Which AI tools does it work with?</summary>

It works with any MCP-compatible client. Supported clients include Claude Code, Claude Desktop, Cursor, Windsurf, and VS Code with an MCP extension.

</details>

<details>

<summary>Do I need to install anything?</summary>

There is no build step. Configure your client to run `npx -y @proxidize/mcp`. Node.js 18 or later downloads and runs it when needed.

</details>

<details>

<summary>Why do I only see `get_subscription` and `get_outbound_ip`?</summary>

Those tools always load. The server registers other tools from your active subscriptions. Check your token and subscription if expected tools are missing.

</details>

<details>

<summary>Does it send my data anywhere?</summary>

The server collects anonymous tool, latency, and error data through PostHog. It never sends tool responses. Sensitive parameters are redacted automatically.

Set `PROXIDIZE_DISABLE_ANALYTICS=1` or `DO_NOT_TRACK=1` to opt out.

</details>

<details>

<summary>Can I run it from source instead of npm?</summary>

Yes. Clone the repository, run `npm install` and `npm run build`, then configure your client to run the build output.

</details>

## Resources

Review the [MCP Server repository](https://github.com/proxidize/proxidize-mcp) for source code and development instructions.

Visit the [Proxidize MCP Server overview](https://proxidize.com/tools/mcp-server/) for product details.

## Need Help?

Contact <support@proxidize.com> for connection help.


# Overview

Start here for account setup, subscriptions, payments, invoices, and verification.

Manage account access, subscriptions, payments, invoices, and verification from one place.

Start here if you need to create an account, subscribe to a plan, or fix billing details.

### Start here

* Need account setup help? Go to [Account Management](/account-and-billing/account-management).
* Need subscription or payment help? Go to [Billing and Subscriptions](/account-and-billing/billing-and-subscriptions).
* Need trial or KYC details? Jump to [Verification](#verification).

### Common account tasks

* [Account Creation and Setup](/account-and-billing/account-management/account-creation-and-setup) — Create your account and finish setup.
* [Adding Sub-Accounts in the Proxidize Dashboard](/account-and-billing/account-management/adding-sub-accounts-in-the-proxidize-dashboard) — Give teammates access.
* [How to Change Account Email](/account-and-billing/account-management/how-to-change-account-email) — Update your login email.
* [How to Delete My Proxidize Account](/account-and-billing/account-management/how-to-delete-my-proxidize-account) — Permanently remove your account.

### Common billing tasks

* [How to Subscribe to a Proxidize Plan](/account-and-billing/billing-and-subscriptions/how-to-subscribe-to-a-proxidize-plan) — Start a new subscription.
* [How to Manage Your Subscription in the Proxidize App](/account-and-billing/billing-and-subscriptions/how-to-manage-your-subscription-in-the-proxidize-app) — Review and manage your active plan.
* [How to Upgrade, Downgrade, or Change Your Subscription](/account-and-billing/billing-and-subscriptions/how-to-upgrade-downgrade-or-change-your-subscription) — Switch plans as your needs change.
* [How to Change Your Payment Method](/account-and-billing/billing-and-subscriptions/how-to-change-your-payment-method) — Replace the card on file.
* [How to Pay After a Failed Payment](/account-and-billing/billing-and-subscriptions/how-to-pay-after-a-failed-payment) — Retry payment and restore service.
* [How to Download an Invoice](/account-and-billing/billing-and-subscriptions/how-to-download-an-invoice) — Get invoices for accounting or records.
* [Can I Buy Multiple Subscriptions on One Account](/account-and-billing/billing-and-subscriptions/can-i-buy-multiple-subscriptions-on-one-account) — Check account subscription limits.
* [How to Cancel a Proxidize Subscription](/account-and-billing/billing-and-subscriptions/how-to-cancel-a-proxidize-subscription) — Stop renewal for an active plan.
* [Refund Policy](/account-and-billing/billing-and-subscriptions/refund-policy) — Review refund eligibility.

### Verification

* [How to Subscribe to a Proxidize Plan](/account-and-billing/billing-and-subscriptions/how-to-subscribe-to-a-proxidize-plan) — Review the buying flow before you subscribe.
* [KYC Verification for Proxidize Proxy Users](/getting-started/kyc-verification-for-proxidize-proxy-users) — Complete verification for supported use cases.

### Next step

Once your account and billing are ready, continue with [Quick Start with Proxidize Proxies](/getting-started/quick-start-with-proxidize-proxies).


# Account Management

Create, update, and manage your Proxidize account settings and sub-accounts.

Manage account access, login details, team access, and account removal for your Proxidize account.

Use this page to jump straight to the account task you need.

{% hint style="info" %}
Use this section for account setup, email changes, sub-accounts, and account deletion.
{% endhint %}

### Start here

#### New customer

* [Account Creation and Setup](/account-and-billing/account-management/account-creation-and-setup)

#### Existing customer

* [How to Change Account Email](/account-and-billing/account-management/how-to-change-account-email)
* [Adding Sub-Accounts in the Proxidize Dashboard](/account-and-billing/account-management/adding-sub-accounts-in-the-proxidize-dashboard)
* [How to Delete My Proxidize Account](/account-and-billing/account-management/how-to-delete-my-proxidize-account)

### Account tasks

<table data-view="cards"><thead><tr><th>Title</th><th data-card-target data-type="content-ref">Target</th></tr></thead><tbody><tr><td><strong>Create your account</strong><br>Set up a new Proxidize account and finish the first steps.</td><td><a href="/spaces/iAQa47xivOtQQ7mQZOnQ/pages/bd5de2cdd5392779ea70a8392ff2c5f922198ec4">/spaces/iAQa47xivOtQQ7mQZOnQ/pages/bd5de2cdd5392779ea70a8392ff2c5f922198ec4</a></td></tr><tr><td><strong>Change account email</strong><br>Update the login email tied to your account.</td><td><a href="/spaces/iAQa47xivOtQQ7mQZOnQ/pages/44128153d6db4baaf2e78de7fdb8adf8562c77f9">/spaces/iAQa47xivOtQQ7mQZOnQ/pages/44128153d6db4baaf2e78de7fdb8adf8562c77f9</a></td></tr><tr><td><strong>Add sub-accounts</strong><br>Give teammates access to the Proxidize dashboard.</td><td><a href="/spaces/iAQa47xivOtQQ7mQZOnQ/pages/5d2e1f789c321138e0a98b9a4d86597167a493ca">/spaces/iAQa47xivOtQQ7mQZOnQ/pages/5d2e1f789c321138e0a98b9a4d86597167a493ca</a></td></tr><tr><td><strong>Delete your account</strong><br>Permanently remove your account and understand what happens next.</td><td><a href="/spaces/iAQa47xivOtQQ7mQZOnQ/pages/a9da6e98c792ab1c30089e3e6e58ac3dc8f8be21">/spaces/iAQa47xivOtQQ7mQZOnQ/pages/a9da6e98c792ab1c30089e3e6e58ac3dc8f8be21</a></td></tr></tbody></table>

### What this section covers

* **Account setup** — create a new account and finish onboarding.
* **Access management** — add sub-accounts for teammates who need dashboard access.
* **Identity updates** — change the email used to sign in.
* **Account closure** — remove your account when you no longer need it.

***

### <mark style="color:$primary;">Need help?</mark>

Contact support if:

* you cannot access the account tied to your email
* you need help adding or managing sub-accounts
* you are unsure what happens before deleting your account

Reach us through live chat or email at <support@proxidize.com>.


# Account Creation and Setup

Create a Proxidize account and complete the initial setup steps.

Learn how to create your Proxidize account, sign in, and complete the initial setup.

### Account Creation and Setup

Before you can purchase or manage Proxidize products, you need to create a Proxidize account.

Your account gives you access to the Proxidize app, where you can manage your products, subscriptions, orders, payment methods, and account settings.

### Create a Proxidize account

You can create an account from the Proxidize website or directly from the Proxidize app.

#### Option 1: Sign up from the Proxidize website

1. Go to the Proxidize website.
2. Click **Sign up for free**.
3. You will be redirected to the sign-up page.
4. Follow the on-screen instructions to create your account.

#### Option 2: Sign up from the Proxidize app

1. Go to [**https://app.proxidize.com**](https://app.proxidize.com/).
2. Click **Sign up**.
3. Enter your email address or choose one of the available sign-in options.
4. Follow the on-screen instructions to complete account creation.

![](/files/832ee7ee437f71de76d33bc24c879da1ef63abad)

### Sign in to your account

After creating your account, go to:

[**https://app.proxidize.com**](https://app.proxidize.com/)

You can sign in using the available login options shown on the sign-in page.

Depending on your account setup, you may be able to continue using:

* Google
* Microsoft
* GitHub
* Email

### Complete the initial setup

After signing up, you may be asked to confirm account details or accept required agreements before accessing the app.

Follow the on-screen steps until your account setup is complete.

Once complete, you will be redirected to the Proxidize app.

### What can I do after creating an account?

After your account is created, you can:

* Subscribe to a Proxidize plan
* View and manage your subscriptions
* Access your purchased proxies or services
* View orders and download invoices
* Add or update payment methods
* Manage account settings

### Related Articles

* [Adding Sub-Accounts in the Proxidize Dashboard](/account-and-billing/account-management/adding-sub-accounts-in-the-proxidize-dashboard)

***

### <mark style="color:$primary;">Need Help?</mark>

If you have any questions, concerns, or need further clarification, feel free to reach out to us via live chat or email us directly at **<support@proxidize.com>**.


# Adding Sub-Accounts in the Proxidize Dashboard

Add sub-accounts in the Proxidize Dashboard to share access with your team.

The Sub-Accounts feature allows you to grant team members access to your Proxidize dashboard and proxies using their own email addresses. This enables better collaboration, accountability, and separation of responsibilities when managing proxies as a team.

### Overview

With Sub-Accounts, you can:

* Allow multiple team members to access and manage proxies
* Maintain accountability by assigning access via individual email addresses
* Improve operational workflows (e.g., proxy monitoring, alerting)
* Enable email-based alerting for Proxy Builder setups

![](/files/04478b3572075ee50e58fcf1603eed92c64f94e8)

***

### Permissions & Limitations

#### Role Access

* All Sub-Users are assigned the role **“Proxy Manager”**
* This role provides **full access to the dashboard and proxies**, similar to the account owner

#### Restrictions

Sub-Users cannot:

* Access the **billing portal**
* Add or remove other sub-users

![](/files/a7c3f4a2b03cf6f847573eb714f6389b46b92d77)

***

### Important Requirement

Before creating a Sub-User:

* The email address **must not have been previously used** to create a Proxidize account
* If the user has already signed up before, they must **delete their existing account first.** For assistance, contact [**Proxidize Support**](mailto:support@proxidize.com)

***

## How to Create a Sub-User

{% stepper %}
{% step %}

### Step 1: Navigate to Account Settings

* Log in to your Proxidize dashboard.
* Go to [Account Settings](https://app.proxidize.com/settings/) by clicking on the Profile Icon on the top right of your screen.
* Click on **“Create User”**
  {% endstep %}

{% step %}

### Step 2: Enter User Details

* Fill in:
  * First Name
  * Last Name
  * Email Address
* Click **“Confirm”**

![](/files/e8b4569e9c310c1d59f276d3a8b6f45dc590938f)
{% endstep %}
{% endstepper %}

### What Happens Next (For the Sub-User)

#### Once the user is added

1. The user should go to the login page and enter their email address
2. They will receive a **6-digit verification code via email**
3. Enter the code to log in

#### First-Time Setup

After logging in, the user will need to:

* Complete their profile:
  * First Name
  * Last Name
  * Account Type
  * Organization details *(if applicable)*
* Accept all license agreements

***

### Best Practices

* Use Sub-Accounts to assign responsibilities across your team (e.g., monitoring, maintenance)
* Ensure each team member uses their own email for accountability
* Use email-based alerts effectively when managing Proxy Builder setups

***

### <mark style="color:$primary;">Need Help?</mark>

If you have any questions, concerns, or need further clarification, feel free to reach out to us via live chat or email us directly at **<support@proxidize.com>**.


# How to Change Account Email

Learn how to change the login email address on your Proxidize account.

### What This Does

Changing your account email updates the email address you use to log in to Proxidize.

After the change is complete:

* Your existing products stay attached to your account.
* Your active subscriptions stay attached.
* Your account data is not reset.
* Your KYC verification status stays preserved.
* You will log in using the new email address going forward.

Proxidize uses passwordless login. After changing your email, you will log in with the new email address and receive future login codes there.

***

### Before You Start

Make sure:

* You are logged in to [app.proxidize.com](https://app.proxidize.com/).
* You are using the parent account.
* The new email address is valid.
* The new email address is different from your current login email.
* The new email address is not already used by another Proxidize account.
* You can access the inbox for the new email address.

{% hint style="warning" %}
Sub-accounts cannot change their own email address. If a sub-account needs a new email address, the parent account admin must remove the sub-account and add it again using the new email address.
{% endhint %}

### Change Your Account Email

{% stepper %}
{% step %}

#### Log in to Proxidize

Log in to [app.proxidize.com](https://app.proxidize.com/).
{% endstep %}

{% step %}

#### Open the account settings

or go to this address [app.proxidize.com/settings/](https://www.app.proxidize.com/settings/)
{% endstep %}

{% step %}

#### Click Change Email

![](/files/aa71a3d17b22715d5a32381989d65ca5954a562c)
{% endstep %}

{% step %}

### Enter your new email address

In the **Change Email Address** modal, enter your new email address.

![](/files/a4e9510c6ae27503ecb5c52093ed76b562d1495e)
{% endstep %}

{% step %}

### Click Send Code

Click **Send Code**.
{% endstep %}

{% step %}

### Check the inbox for the new email address

Check the inbox for the new email address. The verification code is sent to the new email address, not your current email address.
{% endstep %}

{% step %}

### Enter the verification code

Enter the 6-digit verification code.
{% endstep %}

{% step %}

### Verify the change

Click **Verify**.
{% endstep %}

{% step %}

### Wait for the change to finish

Wait for the email change to finish processing.

{% hint style="info" %}
Once the change is confirmed, you will be automatically logged out. Log in again using the new email address.
{% endhint %}
{% endstep %}
{% endstepper %}

### Verification Code Rules

* The verification code is sent to the new email address.
* The code expires after 10 minutes.
* If the code expires, restart the change-email flow from the beginning or click on the resent button after 30 seconds have passed.
* If you enter the wrong code, you will see an invalid verification code message.

### If You Cancel or Close the Modal

If you cancel before submitting the new email address, no change request is sent.

If you cancel or close the modal during verification, your email address stays unchanged.

To continue, restart the change-email flow from the beginning.

If you enter the same new email address again while a change request is already in progress, you may see this message:

`You already have an email change in progress.`

If this happens, wait for the current verification code to expire, then restart the flow.

## Email Requirements

The new email address:

* Cannot be empty.
* Must use a valid email format.
* Must be different from your current login email.
* Cannot already be used by another Proxidize account.

Existing-email checks are case-insensitive.

## Troubleshooting

<table data-search="false"><thead><tr><th>Message or Issue</th><th>What It Means</th></tr></thead><tbody><tr><td>Email is required</td><td>No email address was entered before submitting the form.</td></tr><tr><td>Enter a valid email address</td><td>The email address format is invalid.</td></tr><tr><td>New email must be different from your current email</td><td>The new email matches your current login email.</td></tr><tr><td>Already in use or invalid email message</td><td>The email may already be attached to another Proxidize account.</td></tr><tr><td>Invalid verification code</td><td>The code is incorrect or expired. Restart the flow and use the newest code.</td></tr><tr><td>You already have an email change in progress</td><td>A change request already exists for that email. Wait for the current code to expire, then restart the flow.</td></tr><tr><td>You were logged out after verifying</td><td>This is expected. Log in again using the new email address.</td></tr><tr><td>Sub-account cannot change email</td><td>Ask the parent account admin to remove the sub-account and add it again with the new email.</td></tr></tbody></table>

***

### Important Notes

* You must be logged in to change your email address.
* Only parent accounts can change their account email.
* Sub-accounts cannot change their own email address.
* The new email becomes the email used for future logins.
* Your products, subscriptions, KYC status, and account data stay attached after the email change.
* You can change your email more than once, as long as the new email passes validation.

***

### Related account pages

* [Account & Billing Overview](/account-and-billing/overview)
* [Adding Sub-Accounts in the Proxidize Dashboard](/account-and-billing/account-management/adding-sub-accounts-in-the-proxidize-dashboard)
* [Billing and Subscriptions Overview](broken://spaces/iAQa47xivOtQQ7mQZOnQ/pages/a0b5c4a386f91b3cd6849fa1c4ac6b64a71664c8)
* [How to Delete My Proxidize Account](/account-and-billing/account-management/how-to-delete-my-proxidize-account)

***

### <mark style="color:$primary;">Need Help?</mark>

If you have any questions, concerns, or need further clarification, feel free to reach out to us via live chat or email us directly at <support@proxidize.com>.


# How to Delete My Proxidize Account

Delete your Proxidize account and understand what happens next.

This article explains how to request the deletion of your Proxidize account, the ownership verification requirements, exceptions for company accounts, and how your data is handled after deletion.

### Automatic Removal

Accounts with no purchase history that remain inactive for more than 60 days may be automatically removed to keep the system organized.

### Requesting Account Deletion

To submit a deletion request, contact the Proxidize Support Team **directly from the email address associated with the account you want deleted.** This is required to verify account ownership, requests sent from a different email address cannot be processed.

When submitting your request, please include the reason for the deletion so our team can process it efficiently.

{% hint style="warning" %}
**Account deletion is irreversible.** Once processed, you will lose access to your account and any associated configuration or data.
{% endhint %}

### Exception: Same-Domain Company Accounts

If both the requesting email and the account to be deleted share the same company domain, a representative may submit the request on behalf of another account under that domain.

**Example:** `admin@company123.com` may request deletion of `user@company123.com`

In this case, the request must include a **signed letter from an authorized company representative,** such as an account owner, manager, or any individual with signing authority within the organization, explicitly requesting the deletion. Requests without this letter will not be processed.

### What Happens to Your Data

While account access is removed upon deletion, certain information, including purchase and transaction records, may be retained where required for record-keeping, auditing, and compliance purposes.

Our data handling practices follow **ISO 27001** and **SOC Type I & II** standards, ensuring all retained information is handled securely and responsibly.

***

### <mark style="color:$primary;">Need Help?</mark>

If you have any questions, concerns, or need further clarification, feel free to reach out to us via live chat or email us directly at **<support@proxidize.com>**.


# Billing and Subscriptions

Manage Proxidize plans, payments, invoices, subscription changes, and cancellations.

## Billing and Subscriptions

Manage subscriptions, payments, invoices, and billing settings for your Proxidize account.

Most billing actions happen inside the Proxidize app.

<a href="https://app.proxidize.com/" class="button primary" data-icon="arrow-right">Open Proxidize app</a>

{% hint style="info" %}
Use this page to jump straight to the billing task you need.
{% endhint %}

### Start here

If you are new to Proxidize, start with:

* [How to Subscribe to a Proxidize Plan](/account-and-billing/billing-and-subscriptions/how-to-subscribe-to-a-proxidize-plan)
* [Can I Buy Multiple Subscriptions on One Account](/account-and-billing/billing-and-subscriptions/can-i-buy-multiple-subscriptions-on-one-account)

If you already have an account, use:

* **Billing → Subscriptions** for renewals, changes, and cancellations.
* **Billing → Orders** for payment history and invoice downloads.
* **Billing → Payment Methods** for cards and billing details.

### Billing tasks

<table data-view="cards"><thead><tr><th>Title</th><th data-card-target data-type="content-ref">Target</th></tr></thead><tbody><tr><td>Manage subscription<br>View status, renewal date, quantity, and available actions.</td><td><a href="/spaces/iAQa47xivOtQQ7mQZOnQ/pages/332a7bda18474c505a37433265e68d28bfbc2a04">/spaces/iAQa47xivOtQQ7mQZOnQ/pages/332a7bda18474c505a37433265e68d28bfbc2a04</a></td></tr><tr><td>Start a plan<br>Buy proxies or subscribe to a Proxidize plan.</td><td><a href="/spaces/iAQa47xivOtQQ7mQZOnQ/pages/69ee37d9049836eb2871588672f78882c44a8410">/spaces/iAQa47xivOtQQ7mQZOnQ/pages/69ee37d9049836eb2871588672f78882c44a8410</a></td></tr><tr><td>Change your plan<br>Upgrade, downgrade, or adjust your subscription.</td><td><a href="/spaces/iAQa47xivOtQQ7mQZOnQ/pages/4225da742ff40c3b0ac870e61b76d64ad8d63cf0">/spaces/iAQa47xivOtQQ7mQZOnQ/pages/4225da742ff40c3b0ac870e61b76d64ad8d63cf0</a></td></tr><tr><td>Download an invoice<br>Get invoice PDFs for paid orders.</td><td><a href="/spaces/iAQa47xivOtQQ7mQZOnQ/pages/8ccb9d146e5854b3c9070d9be694a3ef07ef33c3">/spaces/iAQa47xivOtQQ7mQZOnQ/pages/8ccb9d146e5854b3c9070d9be694a3ef07ef33c3</a></td></tr><tr><td>Fix a failed payment<br>Retry payment and restore service after a failed charge.</td><td><a href="/spaces/iAQa47xivOtQQ7mQZOnQ/pages/480ed1e29dfe763ea07b854fbb8670bb67170454">/spaces/iAQa47xivOtQQ7mQZOnQ/pages/480ed1e29dfe763ea07b854fbb8670bb67170454</a></td></tr><tr><td>Update payment method<br>Add, remove, or replace saved cards.</td><td><a href="/spaces/iAQa47xivOtQQ7mQZOnQ/pages/4d26c456785443aba1a5c2887e05eb9741b870e1">/spaces/iAQa47xivOtQQ7mQZOnQ/pages/4d26c456785443aba1a5c2887e05eb9741b870e1</a></td></tr><tr><td>Cancel subscription<br>Stop renewal and keep access until the current period ends.</td><td><a href="/spaces/iAQa47xivOtQQ7mQZOnQ/pages/5c2e790d2e75de1ec38a9af0f82b67064872287e">/spaces/iAQa47xivOtQQ7mQZOnQ/pages/5c2e790d2e75de1ec38a9af0f82b67064872287e</a></td></tr><tr><td>Review refund terms<br>Check refund eligibility and policy details.</td><td><a href="/spaces/iAQa47xivOtQQ7mQZOnQ/pages/7d8085f432d0446deda37dd9ffe9a31bed2ba443">/spaces/iAQa47xivOtQQ7mQZOnQ/pages/7d8085f432d0446deda37dd9ffe9a31bed2ba443</a></td></tr></tbody></table>

### Where to find billing actions in the app

* **Billing → Subscriptions** shows status, next invoice date, related orders, and plan actions.
* **Billing → Orders** shows payment history and invoice PDFs.
* **Billing → Payment Methods** shows saved cards and billing information.

### Quick FAQ

<details>

<summary>Where do I manage my billing details?</summary>

Open **Billing** in the Proxidize app.

Use **Subscriptions**, **Orders**, or **Payment Methods** depending on the task.

</details>

<details>

<summary>Where do I download invoices?</summary>

Open **Billing → Orders**.

Then click **PDF** next to the paid order.

</details>

<details>

<summary>Where do I cancel or change a subscription?</summary>

Open **Billing → Subscriptions**.

Use the **Actions** menu for the subscription you want to manage.

</details>

### <mark style="color:$primary;">Need help?</mark>

Contact support if:

* a payment failed and you do not see a retry option
* an invoice is missing from **Billing → Orders**
* your subscription status looks wrong after a payment or cancellation
* the wrong number of proxies shows in your dashboard

Reach us through live chat or email at <support@proxidize.com>.


# How to Subscribe to a Proxidize Plan

Subscribe to a Proxidize plan and start using your proxy service.

## How to Subscribe to a Proxidize Plan

Create an account, choose a product, and complete checkout from the website or the app.

New customers usually start on the website.

Existing customers usually buy directly from the app.

<a href="https://app.proxidize.com/" class="button primary" data-icon="arrow-right">Open Proxidize app</a>

### Before you start

You need a Proxidize account before you buy a plan.

You can create one in either place:

| Option      | What to do                                           |
| ----------- | ---------------------------------------------------- |
| **Website** | Click **Sign up for free** on the Proxidize website. |
| **App**     | Open the Proxidize app and create a free account.    |

### Buy from the Proxidize website

Use this flow if you start from a pricing or product page.

1. Open the Proxidize website.
2. Choose the product or plan you want.
3. Select the package, quantity, or GB amount.
4. Continue to checkout.
5. Review the order summary.
6. Add a coupon code if needed.
7. Choose your payment method.
8. Complete the purchase.

After checkout, your proxies appear in your account immediately.

### Buy from the Proxidize app

Use this flow if you are already logged in.

1. Open the Proxidize app.
2. Go to the product you want to buy.
3. Open the **Buy** tab or the plan page.
4. Select your package, quantity, GB amount, or plan.
5. Click **Buy Now**.
6. Review your order.
7. Add a coupon code if needed.
8. Choose your payment method.
9. Complete the purchase.

![](/files/d8fad847adc986253828ca28333c620fae82d738)

### Supported payment methods

You can pay with a credit card or debit card.

{% hint style="info" %}
PayPal, Google Pay, and other payment processors are not currently supported.
{% endhint %}

### Add a coupon code

You can apply a coupon during checkout.

1. Click **Have a coupon? Click here to enter your code**.
2. Enter your coupon code.
3. Apply the code.
4. Review the updated total.

![](/files/89a813d1ec1eb9b4b5bce29936d1d678a7c2d5c6)

### What happens after purchase

After payment is complete:

* your proxies appear in your account immediately
* your subscription appears under **Billing → Subscriptions**
* your order appears under **Billing → Orders**
* your invoice becomes available from **Orders**

### Quick FAQ

<details>

<summary>Should I buy from the website or the app?</summary>

Use the website if you are new to Proxidize.

Use the app if you already have an account and want to buy from inside it.

</details>

<details>

<summary>When do my proxies appear after purchase?</summary>

Your proxies appear in your account immediately after checkout is complete.

</details>

<details>

<summary>Can I use a coupon code at checkout?</summary>

Yes.

Enter the coupon code on the checkout page before you complete payment.

</details>

<details>

<summary>Where do I find my subscription after buying?</summary>

Open **Billing → Subscriptions** in the Proxidize app.

Your related order appears in **Billing → Orders**.

</details>

### Related articles

* [How to Manage Your Subscription in the Proxidize App](/account-and-billing/billing-and-subscriptions/how-to-manage-your-subscription-in-the-proxidize-app)
* [How to Upgrade, Downgrade, or Change Your Subscription](/account-and-billing/billing-and-subscriptions/how-to-upgrade-downgrade-or-change-your-subscription)
* [How to Download an Invoice](/account-and-billing/billing-and-subscriptions/how-to-download-an-invoice)
* [How to Pay After a Failed Payment](/account-and-billing/billing-and-subscriptions/how-to-pay-after-a-failed-payment)
* [How to Change Your Payment Method](/account-and-billing/billing-and-subscriptions/how-to-change-your-payment-method)

### <mark style="color:$primary;">Need help?</mark>

Reach us through live chat or email at **<support@proxidize.com>**.


# How to Manage Your Subscription in the Proxidize App

Manage your active Proxidize subscription from the Proxidize app.

## How to Manage Your Subscription in the Proxidize App

Use the **Subscriptions** page in the Proxidize app to review status, orders, renewals, and cancellations.

<a href="https://app.proxidize.com/" class="button primary" data-icon="arrow-right">Open Proxidize app</a>

### What you can manage from this page

From **Billing → Subscriptions**, you can:

1. view active and past subscriptions
2. check subscription details
3. open related orders
4. cancel an active subscription
5. reactivate a subscription that is pending cancellation
6. complete payment for an on-hold subscription

### Open the Subscriptions page

1. Log in to the Proxidize app.
2. Open **Billing**.
3. Click **Subscriptions** in the left sidebar.

![](/files/922dad353e2e3f2e3bdbdc273c156e50dd214f6a)

Each row shows key details:

| Column           | Description                                                  |
| ---------------- | ------------------------------------------------------------ |
| **ID**           | The subscription ID.                                         |
| **Product**      | The product tied to the subscription.                        |
| **Quantity**     | The number of proxies, endpoints, or GB in the subscription. |
| **Price**        | The monthly subscription price.                              |
| **Next Invoice** | The next billing date.                                       |
| **Status**       | The current subscription status.                             |
| **Actions**      | The actions available for that subscription.                 |

![](/files/150164d5f85febbf0b7c29f682e7b41fc212ff9b)

### Understand subscription statuses

| Status             | What it means                                                                   |
| ------------------ | ------------------------------------------------------------------------------- |
| **Active**         | The subscription is active.                                                     |
| **On Hold**        | Payment is required before service continues normally.                          |
| **Pending Cancel** | The subscription will stop at the end of the billing period unless reactivated. |
| **Cancelled**      | The subscription has already ended.                                             |

{% hint style="info" %}
Available actions depend on the subscription status and product type.
{% endhint %}

### Use the actions menu

1. Find the subscription you want to manage.
2. Click the **three-dot menu** in the **Actions** column.
3. Choose the action you need.

Common actions include:

| Action                      | What it does                                          |
| --------------------------- | ----------------------------------------------------- |
| **View Orders**             | Opens the orders related to that subscription.        |
| **Renew / Pay**             | Lets you pay for a subscription that is on hold.      |
| **Reactivate Subscription** | Restarts a subscription that is pending cancellation. |
| **Cancel Subscription**     | Stops the next renewal for an active subscription.    |
| **Buy GB**                  | Adds more GB for an eligible Per GB subscription.     |
| **Switch Subscription**     | Opens the flow to change an eligible subscription.    |

![](/files/d90f9af973bcf4ec4fc27ca72b60ba9d4334f3d0)

### View orders related to a subscription

Use **View Orders** to open the order history for one subscription.

This helps when you want to review payments, renewals, or invoices.

![](/files/a3e68681902e5a48d1c4a740303084e5b193e6e4)

To download an invoice, see [How to Download an Invoice](/account-and-billing/billing-and-subscriptions/how-to-download-an-invoice).

### Renew an on-hold subscription

If a subscription shows **On Hold**, use **Renew / Pay** from the **Actions** menu.

After payment is complete, the subscription status should update automatically.

For full steps, see [How to Pay After a Failed Payment](/account-and-billing/billing-and-subscriptions/how-to-pay-after-a-failed-payment).

### Reactivate a pending cancellation

If a subscription shows **Pending Cancel**, use **Reactivate Subscription** before the current billing period ends.

This keeps the subscription active and restores the next renewal.

### Cancel a subscription

If a subscription is active, use **Cancel Subscription** from the **Actions** menu.

The subscription moves to **Pending Cancel** and stays active until the current billing period ends.

For full steps, see [How to Cancel a Proxidize Subscription](/account-and-billing/billing-and-subscriptions/how-to-cancel-a-proxidize-subscription).

### Quick FAQ

<details>

<summary>Where can I view all my subscriptions?</summary>

Open the **Subscriptions** page in the Proxidize app.

It lists active and past subscriptions with status, price, quantity, and actions.

</details>

<details>

<summary>Why do different subscriptions show different actions?</summary>

Actions depend on the subscription status and product type.

For example, an active subscription may show **Cancel Subscription** or **Switch Subscription**.

</details>

<details>

<summary>What does On Hold mean?</summary>

It means payment is required before the subscription continues normally.

You can pay from **Subscriptions** or from the related order in **Orders**.

</details>

<details>

<summary>What does Pending Cancel mean?</summary>

It means the subscription is set to stop at the end of the current billing period.

You can still reactivate it before that date.

</details>

<details>

<summary>Can I upgrade or downgrade from this page?</summary>

Yes, for eligible subscriptions.

Use **Switch Subscription** from the **Actions** menu.

</details>

### <mark style="color:$primary;">Need help?</mark>

Reach us through live chat or email at **<support@proxidize.com>**.


# How to Upgrade, Downgrade, or Change Your Subscription

Upgrade, downgrade, or switch your Proxidize subscription plan.

## How to Upgrade, Downgrade, or Change Your Subscription

Change your Proxidize subscription from the app.

The exact flow depends on the subscription type.

<a href="https://app.proxidize.com/" class="button primary" data-icon="arrow-right">Open Proxidize app</a>

### Before you start

These subscription types support different changes:

| Subscription type    | What you can change                                          |
| -------------------- | ------------------------------------------------------------ |
| **Mobile Per Proxy** | Increase or decrease the number of proxies.                  |
| **Per GB**           | Add more GB or stop a specific GB package from renewing.     |
| **Proxy Builder**    | Change endpoint count, switch plan, or change billing cycle. |

{% hint style="info" %}
Per GB subscriptions work differently from Per Proxy and Proxy Builder subscriptions.
{% endhint %}

### Change a Mobile Per Proxy subscription

Use the **Buy** tab to change the number of proxies in your subscription.

You can open it from:

| Option                  | Where to go                                                                                      |
| ----------------------- | ------------------------------------------------------------------------------------------------ |
| **Per Proxy dashboard** | Click **Buy More** or open the **Buy** tab.                                                      |
| **Billing**             | Open **Billing → Subscriptions**, then choose **Switch Subscription** from the **Actions** menu. |

To change the subscription:

1. Move the slider to the total number of proxies you want.
2. Review the updated summary.
3. Check **Today’s charge** and the new recurring price.
4. Click **Switch Now**.

![](/files/5eb4b40a9c36ce15a813cf611c05f0a3e2328424)

{% hint style="info" %}
The slider shows your new total proxy count, not the number of extra proxies to add.
{% endhint %}

If you upgrade, you pay a prorated amount for the rest of the current billing cycle.

If you downgrade, you are not charged, but you lose access to the removed proxies.

### Change a Per GB subscription

Per GB subscriptions do not downgrade like Per Proxy subscriptions.

When you add GB, Proxidize creates a separate subscription with its own billing period.

You can open the **Buy** tab from:

| Option               | Where to go                                                                         |
| -------------------- | ----------------------------------------------------------------------------------- |
| **Per GB dashboard** | Click **Buy More** or open the **Buy** tab.                                         |
| **Billing**          | Open **Billing → Subscriptions**, then choose **Buy GB** from the **Actions** menu. |

To add more GB:

1. Move the slider to the amount you want.
2. Review the price.
3. Click **Buy Now**.
4. Complete the payment.

![](/files/23d1c9b8a82f1d222d9e92e96e72dc9539eaf92c)

{% hint style="warning" %}
Each GB purchase creates a separate subscription with its own renewal date.
{% endhint %}

To stop a Per GB package from renewing:

1. Open **Billing → Subscriptions**.
2. Find the GB package you want to stop.
3. Open the **Actions** menu.
4. Click **Cancel Subscription**.
5. Confirm the cancellation.

![](/files/a7d12a7ef8af59015bae8bc6ff459e04c570b38c)

Existing GB stays available until its normal expiration date.

### Change a Proxy Builder subscription

Use the **Plans** page to change endpoint count, plan, or billing cycle.

You can open it from:

| Option                      | Where to go                                                                                      |
| --------------------------- | ------------------------------------------------------------------------------------------------ |
| **Proxy Builder dashboard** | Click **Plans** in the left sidebar.                                                             |
| **Billing**                 | Open **Billing → Subscriptions**, then choose **Switch Subscription** from the **Actions** menu. |

To change the subscription:

1. Move the slider to the endpoint count you want.
2. Select the plan you want.
3. Choose **Monthly** or **Annual** if needed.
4. Review today’s charge and the new recurring price.
5. Confirm the change.

![](/files/aa8ee60dcd841243f3dc9f2ea647faff8b4d24e0)

If you upgrade, you pay a prorated amount for the rest of the billing cycle.

If you downgrade, you are not charged, but you lose access to the removed endpoints.

Changing between **Monthly** and **Annual** billing applies immediately.

### Summary

| Subscription type    | Upgrade behavior                                             | Downgrade behavior                                         |
| -------------------- | ------------------------------------------------------------ | ---------------------------------------------------------- |
| **Mobile Per Proxy** | You pay a prorated charge for the rest of the billing cycle. | You pay nothing, but lose access to the removed proxies.   |
| **Per GB**           | Adding GB creates a separate subscription.                   | Cancel the specific GB package to stop renewal.            |
| **Proxy Builder**    | You pay a prorated charge for endpoint or plan upgrades.     | You pay nothing, but lose access to the removed endpoints. |

### Quick FAQ

<details>

<summary>Can I downgrade a PerGB subscription?</summary>

Not in the same way as Per Proxy.

To downgrade, cancel the specific GB package from **Billing → Subscriptions**.

</details>

<details>

<summary>Will I be charged immediately when I upgrade?</summary>

Yes.

Eligible upgrades charge a prorated amount for the rest of the current billing cycle.

</details>

<details>

<summary>What happens if I downgrade?</summary>

You are not charged for the downgrade.

You lose access to the removed proxies or endpoints after the change is confirmed.

</details>

### Related articles

* [How to Manage Your Subscription in the Proxidize App](/account-and-billing/billing-and-subscriptions/how-to-manage-your-subscription-in-the-proxidize-app)
* [How to Cancel a Proxidize Subscription](/account-and-billing/billing-and-subscriptions/how-to-cancel-a-proxidize-subscription)
* [How to Pay After a Failed Payment](/account-and-billing/billing-and-subscriptions/how-to-pay-after-a-failed-payment)
* [How to Download an Invoice](/account-and-billing/billing-and-subscriptions/how-to-download-an-invoice)

### <mark style="color:$primary;">Need help?</mark>

Reach us through live chat or email at **<support@proxidize.com>**.


# How to Pay After a Failed Payment

Resolve a failed payment and restore your Proxidize subscription.

## How to Pay After a Failed Payment

Pay for an on-hold subscription or for a pending order from the Proxidize app.

If a subscription payment fails, the subscription may move to **On Hold**.

{% hint style="info" %}
Proxidize provides a 5-day grace period after a failed payment.
{% endhint %}

### Before you start

Open **Billing** in the Proxidize app.

<a href="https://app.proxidize.com/" class="button primary" data-icon="arrow-right">Open Proxidize app</a>

![](/files/4aec70819515865ccff95a76eff8139d4f159ac8)

### Pay from the Subscriptions page

Use this method if the subscription shows **On Hold**.

1. Open **Subscriptions**.
2. Find the subscription with the **On Hold** status.
3. Open the **Actions** menu.
4. Click **Renew Subscription**.
5. Complete the payment.

After payment is complete, the subscription should become active again.

![](/files/e5b0d376753c426107f3a31204b3236a63653028)

### Pay from the Orders page

You can also pay from the related order.

1. Open **Orders**.
2. Find the order with a **Pending** or **Failed** status.
3. Click **Pay** in the **Actions** column.
4. Complete the payment.

After payment is complete, the order should show **Paid** and the related subscription should be restored.

![](/files/95f8dd44cbcc2a12583d293b11e2246cd76304b9)

### What happens after payment

After payment succeeds:

* the related order should update to **Paid**
* the subscription should become active again
* access to your proxies should be restored

{% hint style="info" %}
If payment succeeded but your service was not restored, contact support before trying to pay again.
{% endhint %}

### If the payment fails again

Check that your payment method is valid and has enough funds.

If needed, update your card and try again.

See [How to Change Your Payment Method](/account-and-billing/billing-and-subscriptions/how-to-change-your-payment-method).

### Quick FAQ

<details>

<summary>How long do I have to fix a failed payment?</summary>

You have a 5-day grace period.

If payment is not completed in that time, access to your proxies along with any configuration you have (e.g. tags, location settings, etc.) will be lost.

</details>

<details>

<summary>Where should I pay from?</summary>

Use **Subscriptions** if the subscription shows **On Hold**.

Use **Orders** if you want to pay the related pending or failed order directly.

</details>

<details>

<summary>What if I paid but my subscription did not reactivate?</summary>

Contact support before making another payment.

</details>

### Related articles

* [How to Change Your Payment Method](/account-and-billing/billing-and-subscriptions/how-to-change-your-payment-method)
* [How to Manage Your Subscription in the Proxidize App](/account-and-billing/billing-and-subscriptions/how-to-manage-your-subscription-in-the-proxidize-app)
* [How to Download an Invoice](/account-and-billing/billing-and-subscriptions/how-to-download-an-invoice)

### <mark style="color:$primary;">Need help?</mark>

Reach us through live chat or email at **<support@proxidize.com>**.


# How to Download an Invoice

Download invoices for your Proxidize subscription and billing history.

## How to Download an Invoice

Download invoice PDFs for paid orders from the Proxidize app.

Invoices are available from **Billing → Orders**.

### Before you start

Open **Billing** in the Proxidize app.

<a href="https://app.proxidize.com/" class="button primary" data-icon="arrow-right">Open Proxidize app</a>

![](/files/4aec70819515865ccff95a76eff8139d4f159ac8)

### Download an invoice from Orders

1. Open **Orders**.
2. Find the order you want.
3. Click **PDF** in the **Actions** column.
4. Download the invoice file.

![](/files/ed25bb06c17415de15cf6ae08f959147c8e7cfae)

### When an invoice is available

Invoices are usually available after payment is complete.

If the order is still **Pending** or **Failed**, the invoice may not appear yet.

### If you cannot find your invoice

Contact support and include:

| Detail              | What to provide                                               |
| ------------------- | ------------------------------------------------------------- |
| **Account email**   | The email address on your Proxidize account.                  |
| **Order ID**        | The order ID shown on the **Orders** page.                    |
| **Subscription ID** | The subscription ID if the order is linked to a subscription. |
| **Payment date**    | The payment date.                                             |

These details help us find the invoice faster.

### Quick FAQ

<details>

<summary>Where do I download invoices?</summary>

Open **Billing → Orders**.

Then click **PDF** next to the paid order.

</details>

<details>

<summary>Why is the PDF button missing?</summary>

The order may still be unpaid.

Invoices usually appear after payment is complete.

</details>

<details>

<summary>What should I send if support needs to help?</summary>

Send your account email, order ID, subscription ID if relevant, and payment date.

</details>

### Related articles

* [How to Manage Your Subscription in the Proxidize App](/account-and-billing/billing-and-subscriptions/how-to-manage-your-subscription-in-the-proxidize-app)
* [How to Pay After a Failed Payment](/account-and-billing/billing-and-subscriptions/how-to-pay-after-a-failed-payment)
* [How to Subscribe to a Proxidize Plan](/account-and-billing/billing-and-subscriptions/how-to-subscribe-to-a-proxidize-plan)

### <mark style="color:$primary;">Need help?</mark>

Reach us through live chat or email at **<support@proxidize.com>**.


# How to Change Your Payment Method

Update the payment method tied to your Proxidize subscription.

## How to Change Your Payment Method

Manage saved cards and billing information from the **Payment Methods** page in the Proxidize app.

<a href="https://app.proxidize.com/" class="button primary" data-icon="arrow-right">Open Proxidize app</a>

### What you can do on this page

From **Billing → Payment Methods**, you can:

* add a new card
* remove a saved card
* set a default card
* edit billing information for invoices and receipts

{% hint style="info" %}
The **Payment Methods** page supports card payments only.
{% endhint %}

### Before you start

Open **Billing** in the Proxidize app.

![](/files/4aec70819515865ccff95a76eff8139d4f159ac8)

### Open the Payment Methods page

1. Click **Payment Methods** in the left sidebar.
2. Review your saved cards and billing information.

![](/files/025ea3b742e4e64d817b886b46d799c08b6f95d1)

### Add a new card

1. Click **Add new card**.
2. Enter your card details.
3. Select your country or territory.
4. Click **Add Card**.

The new card appears in your saved payment methods.

![](/files/b8188ccf862d164da3b38babf3f4d136f84894a5)

### Remove a card or set a default card

1. Find the card you want to manage.
2. Click the **three-dot menu** on that card.
3. Click **Remove card** or **Set as Default**.

{% hint style="info" %}
Removing a card stops it from being used for future saved card payments.
{% endhint %}

![](/files/48a15342c38b6f2ae9265ab1eed417ad58a94d1f)

### Edit billing information

1. Scroll to **Billing Information**.
2. Click **Edit**.
3. Update your details.
4. Save your changes.

![](/files/f5bfa4ac66409faafa35891cbdc15938f4e9fcbe)

### After updating your payment method

If you updated your card because of a failed or pending payment, return to the payment and try again.

Use:

* **Subscriptions → Renew Subscription**
* **Orders → Pay**

### Quick FAQ

<details>

<summary>Can I add more than one saved card?</summary>

Yes.

The **Payment Methods** page can store multiple cards.

</details>

<details>

<summary>Can I choose a default card?</summary>

Yes.

Use the **three-dot menu** on the card and select **Set as Default**.

</details>

<details>

<summary>Will changing my card retry a failed payment automatically?</summary>

Not always.

After updating the card, return to the failed payment and complete it from **Subscriptions** or **Orders**.

</details>

### Related articles

* [How to Pay After a Failed Payment](/account-and-billing/billing-and-subscriptions/how-to-pay-after-a-failed-payment)
* [How to Manage Your Subscription in the Proxidize App](/account-and-billing/billing-and-subscriptions/how-to-manage-your-subscription-in-the-proxidize-app)
* [How to Subscribe to a Proxidize Plan](/account-and-billing/billing-and-subscriptions/how-to-subscribe-to-a-proxidize-plan)

### <mark style="color:$primary;">Need help?</mark>

Reach us through live chat or email at **<support@proxidize.com>**.


# Can I Buy Multiple Subscriptions on One Account

Learn whether one Proxidize account can hold multiple subscriptions.

## Can I Buy Multiple Subscriptions on One Account

Yes.

One Proxidize account can hold multiple subscriptions.

### When you may have multiple subscriptions?

You may see multiple subscriptions if you:

* buy more than one Proxidize product
* add GB to a Mobile or Residential Per GB plan
* buy separate packages with different billing periods

### How Per GB subscriptions work

Per GB subscriptions work differently from Per Proxy and Proxy Builder subscriptions.

Each additional GB purchase creates a separate subscription with its own billing period.

That is why you may see multiple Per GB subscriptions in **Billing → Subscriptions**.

### Where to view your subscriptions

Open **Billing → Subscriptions** in the Proxidize app.

From there, you can review each subscription’s product, quantity, price, next invoice date, status, and actions.

For a full walkthrough, see [How to Manage Your Subscription in the Proxidize App](/account-and-billing/billing-and-subscriptions/how-to-manage-your-subscription-in-the-proxidize-app).

### Can you cancel only one subscription

Yes.

You can cancel one subscription without affecting the others.

For Per GB subscriptions, cancelling one package stops only that package from renewing.

Existing GB from that package remains available until its normal expiration date.

For full steps, see [How to Cancel a Proxidize Subscription](/account-and-billing/billing-and-subscriptions/how-to-cancel-a-proxidize-subscription).

### Quick FAQ

<details>

<summary>Can one account have subscriptions for different products?</summary>

Yes.

One account can hold subscriptions for different Proxidize products at the same time.

</details>

<details>

<summary>Why do I see more than one Per GB subscription?</summary>

Each GB purchase creates its own subscription and renewal date.

</details>

<details>

<summary>Can I cancel only one of my subscriptions?</summary>

Yes.

You can cancel the specific subscription you no longer want to renew.

</details>

### <mark style="color:$primary;">Need help?</mark>

Reach us through live chat or email at **<support@proxidize.com>**.


# How to Cancel a Proxidize Subscription

Cancel your Proxidize subscription and understand how billing stops.

## How to Cancel a Proxidize Subscription

Cancel an active subscription from the Proxidize app and keep access until the end of the current billing period.

### Before you start

Open **Billing** in the Proxidize app.

<a href="https://app.proxidize.com/" class="button primary" data-icon="arrow-right">Open Proxidize app</a>

![](/files/4aec70819515865ccff95a76eff8139d4f159ac8)

### Cancel your subscription

{% stepper %}
{% step %}

#### Open **Subscriptions**

{% endstep %}

{% step %}

#### Find the subscription you want to cancel

{% endstep %}

{% step %}

#### Open the **Actions** menu

{% endstep %}

{% step %}

#### Click **Cancel Subscription**

{% endstep %}

{% step %}

#### Review the confirmation window

{% endstep %}

{% step %}

#### Click **Confirm cancel**

{% endstep %}
{% endstepper %}

After confirmation, the status changes to **Pending Cancel**.

![](/files/928343604cad6b15b53fb568cb15776a371e3cdf)

### What happens after cancellation

After you cancel:

* the subscription stays active until the current billing period ends
* you keep access to your proxies until the next billing date
* the subscription does not renew again
* the status shows **Pending Cancel** until the end date

{% hint style="info" %}
Cancelling a subscription stops the next renewal.
{% endhint %}

### Reactivate before the subscription ends

If the subscription still shows **Pending Cancel**, you can reactivate it before the current billing period ends.

1. Open **Subscriptions**.
2. Find the subscription marked **Pending Cancel**.
3. Open the **Actions** menu.
4. Click **Reactivate Subscription**.

Once reactivated, the subscription continues normally.

### Quick FAQ

<details>

<summary>Does cancellation stop access immediately?</summary>

No.

You keep access until the end of the current billing period.

</details>

<details>

<summary>Can I reactivate a cancelled subscription?</summary>

Yes, if it still shows **Pending Cancel**.

Reactivate it before the current billing period ends.

</details>

<details>

<summary>Where do I cancel the subscription?</summary>

Open **Billing → Subscriptions**.

Use **Cancel Subscription** from the **Actions** menu.

</details>

### Related articles

* [How to Manage Your Subscription in the Proxidize App](/account-and-billing/billing-and-subscriptions/how-to-manage-your-subscription-in-the-proxidize-app)
* [Can I Buy Multiple Subscriptions on One Account](/account-and-billing/billing-and-subscriptions/can-i-buy-multiple-subscriptions-on-one-account)
* [How to Upgrade, Downgrade, or Change Your Subscription](/account-and-billing/billing-and-subscriptions/how-to-upgrade-downgrade-or-change-your-subscription)

### <mark style="color:$primary;">Need help?</mark>

Reach us through live chat or email at **<support@proxidize.com>**.


# Refund Policy

Review the refund terms that apply to Proxidize subscriptions and payments.

## Refund Policy

Review when a subscription payment may be eligible for a refund and how to submit a request.

Proxidize offers a 30-day money-back guarantee for eligible subscription payments.

### Refund eligibility

Refund requests must be submitted within 30 days of the payment date.

Eligibility depends on the product type:

| Product type                   | Refund eligibility                                       |
| ------------------------------ | -------------------------------------------------------- |
| **Mobile Proxies Per Proxy**   | Eligible if total Mobile Per Proxy usage is under 10 GB. |
| **Mobile Proxies Per GB**      | Eligible if usage is under 10 GB.                        |
| **Residential Proxies Per GB** | Eligible if usage is under 10 GB.                        |
| **Proxy Builder**              | Eligible under the 30-day money-back guarantee.          |

{% hint style="warning" %}
The 10 GB usage limit applies to the total data usage across all proxies of the same product type.
{% endhint %}

### How to request a refund

You can request a refund in three ways:

1. Open live chat from the Proxidize website or app, then choose **Billing & Payment** and **Refund Request**.
2. Submit the refund form at <https://proxidize.com/refund-request>.
3. Email **<support@proxidize.com>** with your order number, product, and reason.

![](/files/5eb591703d98fbea150a6b4d02c17b550169749d)

### What happens after a refund is processed

If a refund is approved and processed:

* the related subscription is cancelled automatically
* related proxies or GB are removed
* access tied to that order ends

Requesting a refund is different from cancelling a subscription.

An approved refund also cancels the subscription tied to that order.

### Refund processing time

Refunds are usually processed by Proxidize within 24-48 hours after review.

The final posting time depends on your bank, card provider, or payment processor.

Once processed, you receive a confirmation email.

### Partial refunds

Partial refunds are handled case by case.

If you believe there was a billing error, contact support for review.

### Terms and Conditions

Refunds are subject to Proxidize’s [Terms and Conditions](https://proxidize.com/legal/terms-and-conditions/).

### Quick FAQ

<details>

<summary>Are renewals refundable?</summary>

Yes, if the request is submitted within 30 days of the payment date and the product still meets the refund conditions.

</details>

<details>

<summary>What happens to my subscription after a refund?</summary>

The subscription tied to the refunded order is cancelled automatically.

</details>

<details>

<summary>How long does a refund take?</summary>

Proxidize usually processes refunds within 24-48 hours after review.

Your bank or card provider may take longer to post the funds.

</details>

### <mark style="color:$primary;">Need help?</mark>

Reach us through live chat or email at **<support@proxidize.com>**.


# Proxidize API

Browse the REST API reference for Proxidize mobile, residential, and legacy endpoints.

## What Is the Proxidize API?

The Proxidize API is a **REST API** that lets you connect your own tools, scripts, or applications to your Proxidize account.

You can use the API to automate common proxy management tasks instead of making every change manually from the dashboard.

For exact endpoints, request formats, and response details, refer to the relevant article:

<table data-view="cards"><thead><tr><th></th></tr></thead><tbody><tr><td><a data-mention href="/pages/qTvlCgCFmxDWydEaYwXh">/pages/qTvlCgCFmxDWydEaYwXh</a></td></tr><tr><td><a data-mention href="/pages/oDmgtISwmdM27NOCtEwq">/pages/oDmgtISwmdM27NOCtEwq</a></td></tr><tr><td><a data-mention href="/pages/AigTb6oczq4bocnbSjhb">/pages/AigTb6oczq4bocnbSjhb</a></td></tr><tr><td><a data-mention href="/pages/8bOJHolB5uOIkavpLsJB">/pages/8bOJHolB5uOIkavpLsJB</a></td></tr></tbody></table>

***

## When to Use the API

Use the API when you want to:

* Automate proxy management.
* Do bulk operations on your proxies.
* Connect Proxidize with an internal tool or workflow.
* Retrieve proxy or account information programmatically.
* Manage IP whitelisting for supported plans.
* Look up available proxy locations and ISPs.
* Rotate or update proxies where supported by your plan.
* Manage access points for Per GB plans.

If you only need to make occasional changes, the Proxidize dashboard may be easier to use.

***

## Before You Start

Make sure you have:

* A Proxidize account.
* Access to the Proxidize dashboard.
* Permission to view account settings.
* An API token from your account settings.
* An active product or plan for the API feature you want to use.

The API is available to all Proxidize customers, but the features you can use depend on your active plan.

***

## API Base URL

The Proxidize API base URL is:

`https://api.proxidize.com/api/v1`

All REST API endpoints in the developer documentation use this base URL.

## Get Your API Token

The API uses bearer token authentication.

To copy your API token:

1. Log in to the Proxidize dashboard.
2. Go to [app.proxidize.com/settings](https://www.app.proxidize.com/settings/).
3. Find the **API Token** field.
4. Click the copy button next to **API Token**.
5. Use this token as a bearer token when making API requests.

![](/files/107e73acf7a055beb019e53a4621012f010b913c)

{% hint style="warning" %}
Keep your API token private. Anyone with access to your token may be able to make API requests for your account.
{% endhint %}

***

## Rotate Your API Token

If your API token is exposed, shared by mistake, or used in a system you no longer trust, rotate it from your account settings.

To rotate your API token:

1. Go to [app.proxidize.com/settings](https://www.app.proxidize.com/settings/).
2. Find the **API Token** field.
3. Click the rotate button next to the copy button.
4. Update any scripts, applications, or integrations that were using the old token.

![](/files/d00d5df1007018abb4dc1ee3c8fabe437eb07b60)

{% hint style="info" %}
Rotating the token invalidates the previous token. Any integration still using the old token may stop working until it is updated.
{% endhint %}

***

## API Features by Plan

API features are separated by product type. An endpoint for one plan may not work with another plan.

<table><thead><tr><th width="200.67578125">Plan/API Area</th><th>Available API Features</th></tr></thead><tbody><tr><td><strong>Per Proxy Mobile Proxies</strong></td><td>View proxies, view single proxy details, manage IP whitelisting, look up locations and ISPs, rotate proxies, use rotation URLs, update proxy passwords, set rotation intervals, and manage proxy session tags.</td></tr><tr><td><strong>Per GB: Mobile &#x26; Residential</strong></td><td>View user information, view and manage settings, create and manage access points, manage IP whitelisting, and look up available mobile locations and ISPs.</td></tr></tbody></table>

***

### Per Proxy Mobile API

Use the Per Proxy Mobile API when you want to manage individual mobile proxy sessions.

Depending on your subscription, this API can help you:

* Retrieve proxy lists and proxy details.
* Rotate a proxy.
* Use a rotation URL.
* Update a proxy password.
* Set a rotation interval.
* Manage IP whitelisting.
* Look up available locations and ISPs.
* Create, delete, assign, and remove tags from proxy sessions.

{% hint style="info" %}
Per Proxy features are different from Per GB features. For example, proxy rotation and proxy session tags are Per Proxy Mobile features.
{% endhint %}

***

### Per GB Mobile/Residential API

Use the Per GB Mobile/Residential API when you want to manage Per GB mobile proxy access.

Depending on your subscription, this API can help you:

* View user information.
* View and manage settings.
* Create and manage access points.
* Manage IP whitelisting.
* Look up available mobile locations and ISPs.

{% hint style="info" %}
Per GB access is usually managed through access points and whitelisted source IPs rather than individual proxy sessions.
{% endhint %}

***

## Important Notes

* Keep your API token private.
* Rotate your API token if it is exposed.
* API features depend on your active Proxidize plan.
* Per Proxy endpoints and Per GB endpoints are not interchangeable.
* Some actions may affect active integrations, scripts, or proxy access.
* Use the GitBook developer documentation for exact endpoint usage and examples.

***

## Troubleshooting

| Issue                                                | What to Check                                                              |
| ---------------------------------------------------- | -------------------------------------------------------------------------- |
| API requests are unauthorized                        | Confirm you are using the correct bearer token from account settings.      |
| An integration stopped working after token rotation  | Update the integration with the new API token.                             |
| An endpoint does not work for your account           | Confirm your active plan supports that API feature.                        |
| A Per Proxy endpoint does not work for a Per GB plan | Use the API section that matches your product type.                        |
| Location or ISP filters do not work                  | Use the lookup endpoints in the developer docs to confirm valid values.    |
| IP whitelisting does not allow access                | Confirm the whitelisted IP is the source IP your requests are coming from. |

***

## Related Articles

* [REST API Reference](/proxidize-rest-api/proxidize-api)
* [Mobile Proxies (Per Proxy)](/proxidize-proxies/mobile-proxies/mobile-per-proxy)
* [Mobile Proxies (Per GB)](/proxidize-proxies/mobile-proxies/mobile-pergb)
* [Residential Proxies](/proxidize-proxies/residential-pergb)

***

## Need Help?

If you have any questions, concerns, or need further clarification, feel free to reach out to us via live chat or email us directly at <support@proxidize.com>.


# Mobile - perProxy API

Browse the REST API reference for Per Proxy Mobile Proxies, including proxies, locations, rotation, and tags.

To retrieve the "username"/"super\_user" fields field from the response data, you can access the nested JSON structure. Here's how you can do it for both Python and JavaScript:

Both snippets assume there is at least one entry in the "data" array, indicating an active Per Proxy subscription. Ensure proper error handling for scenarios such as empty arrays or missing fields.

{% tabs %}
{% tab title="Python" %}

```python
import requests

url = "https://api.proxidize.com/api/v1/subscription?type=per_proxy"

headers = {
    "Authorization": "Bearer <API_TOKEN>"
}

response = requests.get(url, headers=headers)
data = response.json()

# Response structure:
# {
#   "data": [
#     {
#       "meta_data": {
#         "username": "your-username"
#       }
#     }
#   ]
# }

print(data)
```

{% endtab %}

{% tab title="Javascript" %}

```javascript
const url = "https://api.proxidize.com/api/v1/subscription?type=per_proxy";

const headers = {
  "Authorization": "Bearer <API_TOKEN>"
};

const response = await fetch(url, {
  method: "GET",
  headers: headers,
});

const data = await response.json();

// Response structure:
// {
//   "data": [
//     {
//       "meta_data": {
//         "username": "your-username"
//       }
//     }
//   ]
// }

console.log(data);
```

{% endtab %}
{% endtabs %}


# IP Whitelist

Reference for the IP Whitelist endpoint for Per Proxy Mobile Proxies.

## POST /perproxy/ip-whitelist

> Create IP whitelist entries for Per Proxy access points

```json
{"openapi":"3.1.1","info":{"title":"Proxidize","version":"1.0.0"},"servers":[{"url":"https://api.proxidize.com/api/v1"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"http","scheme":"Bearer","in":"header","description":"Enter token as: Bearer <token>"}},"schemas":{"PerProxyIPWhitelistCreate":{"type":"object","required":["access_point","super_user"],"properties":{"access_point":{"type":"array","items":{"type":"string"}},"super_user":{"title":"Super user","type":"string"}}}}},"paths":{"/perproxy/ip-whitelist":{"post":{"operationId":"perproxy_ip_whitelist","description":"Create IP whitelist entries for Per Proxy access points","responses":{"201":{"description":"IP whitelist created successfully","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"count":{"type":"integer"}}}}}},"400":{"description":"Error creating IP whitelist","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"409":{"description":"IP whitelist entry already exists for one or more IPs","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}},"tags":["perproxy"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerProxyIPWhitelistCreate"}}},"required":true}}}}}
```


# Proxies

Reference for listing Per Proxy Mobile Proxies through the API.

## GET /perproxy/proxies/{username}

> Refer to <https://developers.proxidize.com/apis/rest-api-reference/per-proxy-mobile-proxies> for details on how to get the username

```json
{"openapi":"3.1.1","info":{"title":"Proxidize","version":"1.0.0"},"servers":[{"url":"https://api.proxidize.com/api/v1"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"http","scheme":"Bearer","in":"header","description":"Enter token as: Bearer <token>"}}},"paths":{"/perproxy/proxies/{username}":{"get":{"operationId":"perproxy_proxies","description":"Refer to https://developers.proxidize.com/apis/rest-api-reference/per-proxy-mobile-proxies for details on how to get the username","parameters":[{"schema":{"type":"integer"},"name":"page","in":"query","description":"Page number","required":false},{"schema":{"type":"integer"},"name":"page_size","in":"query","description":"Page size","required":false},{"schema":{"type":"boolean"},"name":"include_history","in":"query","description":"Include historical proxy sessions","required":false}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"perPage":{"type":"integer"},"page":{"type":"integer"},"total":{"type":"integer"},"data":{"type":"array","items":{"type":"object","properties":{"session_id":{"type":"string"},"proxy":{"type":"string"},"username":{"type":"string"},"password":{"type":"string"},"ip":{"type":"string"},"public_key":{"type":"string"},"rotate_url":{"type":"string"},"total_bytes":{"type":"integer"},"bytes_used":{"type":"integer"},"filter":{"type":"string"},"tags":{"type":"string"},"speed":{"description":"Latest measured proxy speed in Mbps. If this value is 0, rotate the proxy to refresh speed information.","type":"integer"},"speed_test_timestamp":{"description":"Unix timestamp for the latest speed test. If this value is 0, rotate the proxy to refresh speed information.","type":"integer"},"deleted_at":{"type":"string"}}}}}}}}},"400":{"description":"Error retrieving data from service","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}},"tags":["perproxy"]}}}}
```


# Proxy

Reference for retrieving a single Per Proxy Mobile Proxy.

## GET /perproxy/proxy/{username}/{session\_id}

> Refer to <https://developers.proxidize.com/apis/rest-api-reference/per-proxy-mobile-proxies> for details on how to get the username.\
> \
> \
> Session ID can be extracted from proxy string after '-s-' or obtained from session\_id field via api/v1/perproxy/proxies/{username}

```json
{"openapi":"3.1.1","info":{"title":"Proxidize","version":"1.0.0"},"servers":[{"url":"https://api.proxidize.com/api/v1"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"http","scheme":"Bearer","in":"header","description":"Enter token as: Bearer <token>"}}},"paths":{"/perproxy/proxy/{username}/{session_id}":{"get":{"operationId":"perproxy_proxy_detail","description":"Refer to https://developers.proxidize.com/apis/rest-api-reference/per-proxy-mobile-proxies for details on how to get the username.\n\n\nSession ID can be extracted from proxy string after '-s-' or obtained from session_id field via api/v1/perproxy/proxies/{username}","responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"session_id":{"type":"string"},"proxy":{"type":"string"},"username":{"type":"string"},"password":{"type":"string"},"ip":{"type":"string"},"public_key":{"type":"string"},"rotate_url":{"type":"string"},"total_bytes":{"type":"integer"},"bytes_used":{"type":"integer"},"filter":{"type":"string"},"tags":{"type":"string"},"speed":{"description":"Latest measured proxy speed in Mbps. If this value is 0, rotate the proxy to refresh speed information.","type":"integer"},"speed_test_timestamp":{"description":"Unix timestamp for the latest speed test. If this value is 0, rotate the proxy to refresh speed information.","type":"integer"},"deleted_at":{"type":"string"}}}}}},"400":{"description":"Error retrieving data from service","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}},"tags":["perproxy"]}}}}
```


# Locations

Reference for listing available locations for Per Proxy Mobile Proxies.

## GET /perproxy/locations

>

```json
{"openapi":"3.1.1","info":{"title":"Proxidize","version":"1.0.0"},"servers":[{"url":"https://api.proxidize.com/api/v1"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"http","scheme":"Bearer","in":"header","description":"Enter token as: Bearer <token>"}},"schemas":{"Locations":{"type":"object","required":["name","available","average_speed"],"properties":{"name":{"title":"Name","type":"string"},"available":{"title":"Available","type":"boolean"},"average_speed":{"title":"Average speed","type":"integer"}}}}},"paths":{"/perproxy/locations":{"get":{"operationId":"perproxy_location","description":"","responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Locations"}}}}},"400":{"description":"Error retrieving data from service","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}},"tags":["perproxy"]}}}}
```


# Locations (Per ISP)

Reference for listing Per Proxy locations by carrier.

## GET /perproxy/locations-proxy

> List available Per Proxy mobile proxy locations. Optionally filter by carrier

```json
{"openapi":"3.1.1","info":{"title":"Proxidize","version":"1.0.0"},"servers":[{"url":"https://api.proxidize.com/api/v1"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"http","scheme":"Bearer","in":"header","description":"Enter token as: Bearer <token>"}}},"paths":{"/perproxy/locations-proxy":{"get":{"operationId":"perproxy_location_proxy","description":"List available Per Proxy mobile proxy locations. Optionally filter by carrier","parameters":[{"schema":{"type":"string"},"name":"carrier","in":"query","description":"Carrier filter (e.g., '6614')","required":false}],"responses":{"200":{"description":"List of available mobile locations grouped by country","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"country":{"type":"object","properties":{"name":{"description":"Country name (e.g., 'USA')","type":"string"},"value":{"description":"Country filter value (e.g., '-co-USA')","type":"string"},"locations":{"type":"array","items":{"type":"object","properties":{"label":{"description":"Human-readable location label (e.g., 'Dallas, TX')","type":"string"},"value":{"description":"Location filter value (e.g., '-co-USA-st-TX-ci-Dallas')","type":"string"},"average_speed":{"description":"Average proxy speed in the location (kbps)","type":"number"},"country":{"type":"string"},"state":{"type":"string"},"city":{"type":"string"}}}}}}}}}}}},"400":{"description":"Error retrieving data from service","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}},"tags":["perproxy"]}}}}
```


# ISP (Per Location)

Reference for listing available carriers by location for Per Proxy plans.

## GET /perproxy/carriers-proxy

> List available Per Proxy mobile carriers. Filter by location using either the legacy \`location\` param or the newer \`city\`/\`state\`/\`country\` query params

```json
{"openapi":"3.1.1","info":{"title":"Proxidize","version":"1.0.0"},"servers":[{"url":"https://api.proxidize.com/api/v1"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"http","scheme":"Bearer","in":"header","description":"Enter token as: Bearer <token>"}}},"paths":{"/perproxy/carriers-proxy":{"get":{"operationId":"perproxy_carriers_proxy","description":"List available Per Proxy mobile carriers. Filter by location using either the legacy `location` param or the newer `city`/`state`/`country` query params","parameters":[{"schema":{"type":"string"},"name":"location","in":"query","description":"(Legacy) Comma-separated location filter (e.g., 'Bend,  OR, USA'). Prefer using city/state/country params instead","required":false},{"schema":{"type":"string"},"name":"city","in":"query","description":"City filter (e.g., 'Bend')","required":false},{"schema":{"type":"string"},"name":"state","in":"query","description":"State filter (e.g., 'OR'). Requires city to also be provided","required":false},{"schema":{"type":"string"},"name":"country","in":"query","description":"Country filter (e.g., 'USA')","required":false}],"responses":{"200":{"description":"List of available mobile carriers","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"country":{"type":"string"},"value":{"type":"string"},"available":{"type":"boolean"}}}}}}},"400":{"description":"Error retrieving data from service","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}},"tags":["perproxy"]}}}}
```


# Rotate Proxy

Reference for rotating a Per Proxy Mobile Proxy.

## POST /perproxy/rotate

>

```json
{"openapi":"3.1.1","info":{"title":"Proxidize","version":"1.0.0"},"servers":[{"url":"https://api.proxidize.com/api/v1"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"http","scheme":"Bearer","in":"header","description":"Enter token as: Bearer <token>"}}},"paths":{"/perproxy/rotate":{"post":{"operationId":"perproxy_rotate","description":"","responses":{"200":{"description":"Proxy rotated successfully","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"400":{"description":"Error rotating proxy","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"429":{"description":"Too many requests","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}},"tags":["perproxy"],"requestBody":{"content":{"application/json":{"schema":{"required":["username","key","filter"],"type":"object","properties":{"username":{"description":"Refer to https://developers.proxidize.com/apis/rest-api-reference/per-proxy-mobile-proxies","type":"string"},"key":{"description":"Session key - extract from proxy string after '-s-' or get from session_id field via api/v1/perproxy/proxies/{username}","type":"string"},"filter":{"description":"Optional filter criteria for proxy selection","type":"object","properties":{"city":{"description":"City filter (e.g., \"Bend, OR\")","type":"string"},"carrier":{"description":"Carrier filter (e.g., \"Blue\")","type":"string"}}}}}}},"required":true}}}}}
```


# Rotate URL

Reference for retrieving the rotate URL for a Per Proxy Mobile Proxy.

{% openapi src="<https://cloud-django-static.s3.amazonaws.com/static/doc_schema.json>" path="/qps/rotate-url/{rotation\_url}" method="get" %}
<https://cloud-django-static.s3.amazonaws.com/static/doc_schema.json>
{% endopenapi %}


# Rotation URL

Reference for using the rotation URL for Per Proxy Mobile Proxies.

## GET /perproxy/rotate-url/{rotation\_token}

>

```json
{"openapi":"3.1.1","info":{"title":"Proxidize","version":"1.0.0"},"servers":[{"url":"https://api.proxidize.com/api/v1"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"http","scheme":"Bearer","in":"header","description":"Enter token as: Bearer <token>"}}},"paths":{"/perproxy/rotate-url/{rotation_token}":{"get":{"operationId":"perproxy_rotate_url","description":"","responses":{"200":{"description":"Proxy rotated successfully","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"400":{"description":"Error rotating proxy","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"404":{"description":"Proxy not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"429":{"description":"Too many requests","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}},"tags":["perproxy"]}}}}
```


# Update Password

Reference for updating the password for a Per Proxy Mobile Proxy.

## POST /perproxy/update-password

>

```json
{"openapi":"3.1.1","info":{"title":"Proxidize","version":"1.0.0"},"servers":[{"url":"https://api.proxidize.com/api/v1"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"http","scheme":"Bearer","in":"header","description":"Enter token as: Bearer <token>"}},"schemas":{"UpdatePassword":{"type":"object","required":["username","oldPassword","newPassword"],"properties":{"username":{"title":"Username","type":"string","description":"Refer to https://developers.proxidize.com/apis/rest-api-reference/per-proxy-mobile-proxies"},"oldPassword":{"title":"Oldpassword","type":"string","description":"Password must contain only letters and numbers."},"newPassword":{"title":"Newpassword","type":"string","description":"Password must contain only letters and numbers."}}}}},"paths":{"/perproxy/update-password":{"post":{"operationId":"perproxy_update_password","description":"","responses":{"200":{"description":"Proxy password updated successfully","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"400":{"description":"Error updating proxy password","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}},"tags":["perproxy"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePassword"}}},"required":true}}}}}
```


# Set Rotation Interval

Reference for setting the rotation interval for a Per Proxy Mobile Proxy.

## POST /perproxy/set-rotation-interval

>

```json
{"openapi":"3.1.1","info":{"title":"Proxidize","version":"1.0.0"},"servers":[{"url":"https://api.proxidize.com/api/v1"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"http","scheme":"Bearer","in":"header","description":"Enter token as: Bearer <token>"}}},"paths":{"/perproxy/set-rotation-interval":{"post":{"operationId":"perproxy_set_rotation_interval","description":"","responses":{"200":{"description":"Rotation interval updated successfully","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"201":{"description":"Rotation interval set successfully","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"404":{"description":"Rotation interval does not exist to delete","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}},"tags":["perproxy"],"requestBody":{"content":{"application/json":{"schema":{"required":["username","session_id","interval","public_key"],"type":"object","properties":{"username":{"description":"Refer to https://developers.proxidize.com/apis/rest-api-reference/per-proxy-mobile-proxies","type":"string"},"session_id":{"description":"Session ID - extract from proxy string after '-s-' or get from session_id field via api/v1/perproxy/proxies/{username}","type":"string"},"interval":{"description":"Rotation interval in seconds. Use -1 to delete the interval. Minimum 60 seconds, maximum 604800 seconds","type":"integer"},"public_key":{"description":"Public key token used to identify the proxy rotation configuration. This is the unique identifier that appears at the end of the rotation URL (e.g., 'PkxqKLdRFvULobN' in 'https://api.proxidize.com/api/v1/perproxy/rotate-url/PkxqKLdRFvULobN/')","type":"string"}}}}},"required":true}}}}}
```


# Get Tags

Reference for listing tags on Per Proxy Mobile Proxies.

## GET /perproxy/get-tags-user

> Retrieve all tags for the authenticated Per Proxy user

```json
{"openapi":"3.1.1","info":{"title":"Proxidize","version":"1.0.0"},"servers":[{"url":"https://api.proxidize.com/api/v1"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"http","scheme":"Bearer","in":"header","description":"Enter token as: Bearer <token>"}}},"paths":{"/perproxy/get-tags-user":{"get":{"operationId":"perproxy_get_tags_user","description":"Retrieve all tags for the authenticated Per Proxy user","responses":{"200":{"description":"List of tags for the user","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"description":"Tag ID","type":"integer"},"tag":{"description":"Tag name","type":"string"}}}}}}},"400":{"description":"Error performing tag operation","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}},"tags":["perproxy"]}}}}
```


# Create Tag

Reference for creating a tag for Per Proxy Mobile Proxies.

## POST /perproxy/create-tag-user

> Create a new tag for the authenticated Per Proxy user. Tags can be used to organize and group proxy sessions

```json
{"openapi":"3.1.1","info":{"title":"Proxidize","version":"1.0.0"},"servers":[{"url":"https://api.proxidize.com/api/v1"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"http","scheme":"Bearer","in":"header","description":"Enter token as: Bearer <token>"}}},"paths":{"/perproxy/create-tag-user":{"post":{"operationId":"perproxy_create_tag_user","description":"Create a new tag for the authenticated Per Proxy user. Tags can be used to organize and group proxy sessions","responses":{"200":{"description":"Tag created successfully","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"description":"ID of the newly created tag","type":"integer"},"tag":{"description":"Name of the created tag","type":"string"},"username":{"description":"Username the tag belongs to","type":"string"}}}}}},"400":{"description":"Error performing tag operation","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}},"tags":["perproxy"],"requestBody":{"content":{"application/json":{"schema":{"required":["tag"],"type":"object","properties":{"tag":{"description":"Name of the tag to create for the user","type":"string"}}}}},"required":true}}}}}
```


# Delete a Tag

Reference for deleting a tag from Per Proxy Mobile Proxies.

## POST /perproxy/delete-tag-user

> Delete an existing tag for the authenticated Per Proxy user. This removes the tag entirely; any sessions associated with this tag will be untagged

```json
{"openapi":"3.1.1","info":{"title":"Proxidize","version":"1.0.0"},"servers":[{"url":"https://api.proxidize.com/api/v1"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"http","scheme":"Bearer","in":"header","description":"Enter token as: Bearer <token>"}}},"paths":{"/perproxy/delete-tag-user":{"post":{"operationId":"perproxy_delete_tag_user","description":"Delete an existing tag for the authenticated Per Proxy user. This removes the tag entirely; any sessions associated with this tag will be untagged","responses":{"200":{"description":"Tag deleted successfully","content":{"application/json":{"schema":{"type":"object","properties":{"tag_id":{"description":"ID of the deleted tag","type":"integer"},"username":{"description":"Username the tag belonged to","type":"string"}}}}}},"400":{"description":"Error performing tag operation","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}},"tags":["perproxy"],"requestBody":{"content":{"application/json":{"schema":{"required":["tag_id"],"type":"object","properties":{"tag_id":{"description":"ID of the tag to delete","type":"integer"}}}}},"required":true}}}}}
```


# Assign a Tag to a Proxy

Reference for assigning a tag to a Per Proxy Mobile Proxy.

## POST /perproxy/create-tag-session

> Assign a tag to a specific proxy session. The tag must already exist for the user (created via create-tag-user). Session ID can be extracted from the proxy string after '-s-' or obtained from the session\_id field via api/v1/perproxy/proxies/{username}

```json
{"openapi":"3.1.1","info":{"title":"Proxidize","version":"1.0.0"},"servers":[{"url":"https://api.proxidize.com/api/v1"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"http","scheme":"Bearer","in":"header","description":"Enter token as: Bearer <token>"}}},"paths":{"/perproxy/create-tag-session":{"post":{"operationId":"perproxy_create_tag_session","description":"Assign a tag to a specific proxy session. The tag must already exist for the user (created via create-tag-user). Session ID can be extracted from the proxy string after '-s-' or obtained from the session_id field via api/v1/perproxy/proxies/{username}","responses":{"200":{"description":"Tag-session operation completed successfully","content":{"application/json":{"schema":{"type":"object","properties":{"tag_id":{"description":"ID of the tag","type":"integer"},"username":{"description":"Username associated with the operation","type":"string"},"session":{"description":"Session ID involved in the operation","type":"string"}}}}}},"400":{"description":"Error performing tag operation","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}},"tags":["perproxy"],"requestBody":{"content":{"application/json":{"schema":{"required":["tag_id","session"],"type":"object","properties":{"tag_id":{"description":"ID of the tag to assign to the session","type":"integer"},"session":{"description":"Session ID to assign the tag to. Extract from proxy string after '-s-' or get from session_id field via api/v1/perproxy/proxies/{username}","type":"string"}}}}},"required":true}}}}}
```


# Delete a Tag from a Proxy

Reference for removing a tag from a Per Proxy Mobile Proxy.

## POST /perproxy/delete-tag-session

> Remove a tag from a specific proxy session. This only removes the tag-session association; the tag itself is not deleted

```json
{"openapi":"3.1.1","info":{"title":"Proxidize","version":"1.0.0"},"servers":[{"url":"https://api.proxidize.com/api/v1"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"http","scheme":"Bearer","in":"header","description":"Enter token as: Bearer <token>"}}},"paths":{"/perproxy/delete-tag-session":{"post":{"operationId":"perproxy_delete_tag_session","description":"Remove a tag from a specific proxy session. This only removes the tag-session association; the tag itself is not deleted","responses":{"200":{"description":"Tag-session operation completed successfully","content":{"application/json":{"schema":{"type":"object","properties":{"tag_id":{"description":"ID of the tag","type":"integer"},"username":{"description":"Username associated with the operation","type":"string"},"session":{"description":"Session ID involved in the operation","type":"string"}}}}}},"400":{"description":"Error performing tag operation","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}},"tags":["perproxy"],"requestBody":{"content":{"application/json":{"schema":{"required":["tag_id","session"],"type":"object","properties":{"tag_id":{"description":"ID of the tag to remove from the session","type":"integer"},"session":{"description":"Session ID to remove the tag from. Extract from proxy string after '-s-' or get from session_id field via api/v1/perproxy/proxies/{username}","type":"string"}}}}},"required":true}}}}}
```


# Mobile - perGB API

Browse the REST API reference for Per GB Mobile Proxies, including user info, settings, whitelisting, and access points.

To retrieve the "username"/"super\_user" fields from the response data, you can access the nested JSON structure. Here's how you can do it for both Python and JavaScript:

Both snippets assume there is at least one entry in the "data" array, indicating an active Per GB subscription. Ensure proper error handling for scenarios such as empty arrays or missing fields.

{% tabs %}
{% tab title="Python" %}

```python
import requests

url = "https://api.proxidize.com/api/v1/subscription?type=per_gb"

headers = {
    "Authorization": "Bearer <API_TOKEN>"
}

response = requests.get(url, headers=headers)
data = response.json()

# Response structure:
# {
#   "data": [
#     {
#       "meta_data": {
#         "username": "your-username"
#       }
#     }
#   ]
# }

print(data)
```

{% endtab %}

{% tab title="Javascript" %}

```javascript
const url = "https://api.proxidize.com/api/v1/subscription?type=per_gb";

const headers = {
  "Authorization": "Bearer <API_TOKEN>"
};

const response = await fetch(url, {
  method: "GET",
  headers: headers,
});

const data = await response.json();

// Response structure:
// {
//   "data": [
//     {
//       "meta_data": {
//         "username": "your-username"
//       }
//     }
//   ]
// }

console.log(data);
```

{% endtab %}
{% endtabs %}

To retrieve the "username"/"super\_user" fields from the response data, you can access the nested JSON structure. Here's how you can do it for both Python and JavaScript:

Both snippets assume there is at least one entry in the "data" array, indicating an active Per GB subscription. Ensure proper error handling for scenarios such as empty arrays or missing fields.


# Locations (Per ISP)

Reference for listing Per GB Mobile Proxy locations by carrier.

## GET /pergb/mobile/locations-proxy

> List available Per GB mobile proxy locations. Optionally filter by carrier

```json
{"openapi":"3.1.1","info":{"title":"Proxidize","version":"1.0.0"},"servers":[{"url":"https://api.proxidize.com/api/v1"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"http","scheme":"Bearer","in":"header","description":"Enter token as: Bearer <token>"}}},"paths":{"/pergb/mobile/locations-proxy":{"get":{"operationId":"pergb_mobile_locations","description":"List available Per GB mobile proxy locations. Optionally filter by carrier","parameters":[{"schema":{"type":"string"},"name":"carrier","in":"query","description":"Carrier filter (e.g., '6614')","required":false}],"responses":{"200":{"description":"List of available mobile locations grouped by country","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"country":{"type":"object","properties":{"name":{"description":"Country name (e.g., 'USA')","type":"string"},"value":{"description":"Country filter value (e.g., '-co-USA')","type":"string"},"locations":{"type":"array","items":{"type":"object","properties":{"label":{"description":"Human-readable location label (e.g., 'Dallas, TX')","type":"string"},"value":{"description":"Location filter value (e.g., '-co-USA-st-TX-ci-Dallas')","type":"string"},"average_speed":{"description":"Average proxy speed in the location (kbps)","type":"number"},"country":{"type":"string"},"state":{"type":"string"},"city":{"type":"string"}}}}}}}}}}}},"400":{"description":"Error retrieving data from service","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}},"tags":["pergb"]}}}}
```


# ISPs (Per Location)

Reference for listing available carriers by location for Per GB Mobile Proxies.

## GET /pergb/mobile/carriers-proxy

> List available Per GB mobile proxy carriers. Filter by location using either the legacy \`location\` param or the newer \`city\`/\`state\`/\`country\` query params

```json
{"openapi":"3.1.1","info":{"title":"Proxidize","version":"1.0.0"},"servers":[{"url":"https://api.proxidize.com/api/v1"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"http","scheme":"Bearer","in":"header","description":"Enter token as: Bearer <token>"}}},"paths":{"/pergb/mobile/carriers-proxy":{"get":{"operationId":"pergb_mobile_carriers","description":"List available Per GB mobile proxy carriers. Filter by location using either the legacy `location` param or the newer `city`/`state`/`country` query params","parameters":[{"schema":{"type":"string"},"name":"location","in":"query","description":"(Legacy) Comma-separated location filter (e.g., 'Bend,  OR, USA'). Prefer using city/state/country params instead","required":false},{"schema":{"type":"string"},"name":"city","in":"query","description":"City filter (e.g., 'Bend')","required":false},{"schema":{"type":"string"},"name":"state","in":"query","description":"State filter (e.g., 'OR'). Requires city to also be provided","required":false},{"schema":{"type":"string"},"name":"country","in":"query","description":"Country filter (e.g., 'USA')","required":false}],"responses":{"200":{"description":"List of available mobile carriers","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"country":{"type":"string"},"value":{"type":"string"},"available":{"type":"boolean"}}}}}}},"400":{"description":"Error retrieving data from service","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}},"tags":["pergb"]}}}}
```


# User Information

Reference for retrieving user information for Per GB Mobile Proxies.

## GET /pergb/mobile/user-info

> Get user information for the authenticated Per GB user

```json
{"openapi":"3.1.1","info":{"title":"Proxidize","version":"1.0.0"},"servers":[{"url":"https://api.proxidize.com/api/v1"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"http","scheme":"Bearer","in":"header","description":"Enter token as: Bearer <token>"}}},"paths":{"/pergb/mobile/user-info":{"get":{"operationId":"pergb_mobile_user_info","description":"Get user information for the authenticated Per GB user","responses":{"200":{"description":"User information","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"username":{"type":"string"},"password":{"type":"string"},"enabled":{"type":"boolean"},"bytes_used":{"type":"integer"},"bytes_available":{"type":"integer"},"super_user":{"type":"string"},"is_sub_user":{"type":"boolean"},"type":{"type":"string"},"byte_sum":{"type":"integer"},"is_kyc_verified":{"type":"boolean"},"is_crypto_payment":{"type":"boolean"}}}}}},"400":{"description":"Error retrieving data from service","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}},"tags":["pergb"]}}}}
```


# Settings

Reference for retrieving and updating settings for Per GB Mobile Proxies.

## GET /pergb/mobile/settings

> List all access point settings for the authenticated Per GB user

```json
{"openapi":"3.1.1","info":{"title":"Proxidize","version":"1.0.0"},"servers":[{"url":"https://api.proxidize.com/api/v1"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"http","scheme":"Bearer","in":"header","description":"Enter token as: Bearer <token>"}}},"paths":{"/pergb/mobile/settings":{"get":{"operationId":"pergb_mobile_settings_read","description":"List all access point settings for the authenticated Per GB user","responses":{"200":{"description":"List of access point settings","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"access_point":{"type":"string"},"carrier":{"type":"string"},"city":{"type":"string"},"city_name":{"type":"string"},"country":{"type":"string"},"hostname":{"type":"string","enum":["dns","ip"]},"ip_mode":{"type":"string"},"proxy_type":{"type":"string","enum":["socks","http"]}}}}}}}},"tags":["pergb"]}}}}
```


# Whitelisting

Reference for whitelisting endpoints for Per GB Mobile Proxies.

Use whitelisting to limit Mobile proxy access to approved source IPs.

Whitelisting controls **who can connect**.

Country, city, and ISP control **where the proxy exits from**.

To add or update allowed IPs, use [IP Whitelist](/proxidize-rest-api/proxidize-api/mobile-pergb-api/whitelisting/ip-whitelist).

### Format requirements

When you pass `country`, `city`, or `carrier`, use the values returned by the lookup APIs.

Use [Locations (Per ISP)](/proxidize-rest-api/proxidize-api/residential-pergb-api/locations-per-isp) to fetch valid country and city values.

Example response:

```json
[
  {
    "country": {
      "name": "USA",
      "value": "-co-USA",
      "locations": [
        {
          "label": "Baltimore, MD",
          "value": "-co-USA-st-MD-ci-Baltimore",
          "country": "USA",
          "state": "MD",
          "city": "Baltimore"
        }
      ]
    }
  }
]
```

Use:

* `country: USA`
* `city: Baltimore`
* `state: MD`

### Get the correct ISP format

Use [ISPs (Per Location)](/proxidize-rest-api/proxidize-api/mobile-pergb-api/isps-per-location) with the `location` query parameter.

Then use the returned ISPs `value`.

Example response:

```json
[
  {
    "name": "AS6614 T-Mobile USA, Inc.",
    "country": "USA",
    "value": "6614",
    "available": true
  },
]
```

Use:

* `carrier: 6614`

### Example

If you want USA, MD, Baltimore, and ISP AS6614, use:

```
country=USA
state=MD
city=Baltimore
carrier=6614
```


# IP Whitelist

Reference for the IP Whitelist endpoint for Per GB Mobile Proxies.

## POST /pergb/mobile/ip-whitelist

> Create IP whitelist entries for Per GB mobile proxy access points

```json
{"openapi":"3.1.1","info":{"title":"Proxidize","version":"1.0.0"},"servers":[{"url":"https://api.proxidize.com/api/v1"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"http","scheme":"Bearer","in":"header","description":"Enter token as: Bearer <token>"}},"schemas":{"PerGBIPWhitelistCreate":{"type":"object","required":["access_point","super_user"],"properties":{"access_point":{"type":"array","items":{"type":"string"}},"super_user":{"title":"Super user","type":"string"},"session_key":{"title":"Session key","type":"string"},"country":{"title":"Country","type":"string"},"state":{"title":"State","type":"string"},"hostname":{"title":"Hostname","type":"string","enum":["dns","ip"]},"city":{"title":"City","type":"string"},"carrier":{"title":"Carrier","type":"string"},"proxy_type":{"title":"Proxy type","type":"string","enum":["socks","http"]}}}}},"paths":{"/pergb/mobile/ip-whitelist":{"post":{"operationId":"pergb_mobile_ip-whitelist_create","description":"Create IP whitelist entries for Per GB mobile proxy access points","responses":{"201":{"description":"IP whitelist created successfully","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"count":{"type":"integer"}}}}}},"400":{"description":"Error creating or updating IP whitelist","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"409":{"description":"IP whitelist entry already exists for one or more IPs","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}},"tags":["pergb"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerGBIPWhitelistCreate"}}},"required":true}}}}}
```

## PUT /pergb/mobile/ip-whitelist

> Update an existing Per GB mobile IP whitelist entry

```json
{"openapi":"3.1.1","info":{"title":"Proxidize","version":"1.0.0"},"servers":[{"url":"https://api.proxidize.com/api/v1"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"http","scheme":"Bearer","in":"header","description":"Enter token as: Bearer <token>"}},"schemas":{"PerGBIPWhitelistUpdate":{"type":"object","required":["access_point","super_user"],"properties":{"access_point":{"title":"Access point","type":"string"},"super_user":{"title":"Super user","type":"string"},"session_key":{"title":"Session key","type":"string"},"country":{"title":"Country","type":"string"},"state":{"title":"State","type":"string"},"hostname":{"title":"Hostname","type":"string","enum":["dns","ip"]},"city":{"title":"City","type":"string"},"carrier":{"title":"Carrier","type":"string"},"proxy_type":{"title":"Proxy type","type":"string","enum":["socks","http"]}}}}},"paths":{"/pergb/mobile/ip-whitelist":{"put":{"operationId":"pergb_mobile_ip-whitelist_update","description":"Update an existing Per GB mobile IP whitelist entry","responses":{"200":{"description":"IP whitelist updated successfully","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"400":{"description":"Error creating or updating IP whitelist","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"404":{"description":"IP whitelist setting not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"409":{"description":"IP whitelist entry already exists for one or more IPs","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}},"tags":["pergb"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerGBIPWhitelistUpdate"}}},"required":true}}}}}
```


# Access Point

Reference for the access point endpoint for Per GB Mobile Proxies.

## GET /pergb/mobile/access-point

> List all access points (sub-users) for the authenticated Per GB user

```json
{"openapi":"3.1.1","info":{"title":"Proxidize","version":"1.0.0"},"servers":[{"url":"https://api.proxidize.com/api/v1"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"http","scheme":"Bearer","in":"header","description":"Enter token as: Bearer <token>"}}},"paths":{"/pergb/mobile/access-point":{"get":{"operationId":"pergb_mobile_access-point_read","description":"List all access points (sub-users) for the authenticated Per GB user","responses":{"200":{"description":"List of access points","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"username":{"type":"string"},"password":{"type":"string"},"enabled":{"type":"boolean"},"bytes_used":{"type":"integer"},"bytes_available":{"type":"integer"},"super_user":{"type":"string"},"is_sub_user":{"type":"boolean"},"type":{"type":"string"},"byte_sum":{"type":"integer"},"is_kyc_verified":{"type":"boolean"},"is_crypto_payment":{"type":"boolean"}}}}}}},"400":{"description":"Error retrieving data from service","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}},"tags":["pergb"]}}}}
```

## POST /pergb/mobile/access-point

> Create a new access point (sub-user) for the authenticated Per GB user

```json
{"openapi":"3.1.1","info":{"title":"Proxidize","version":"1.0.0"},"servers":[{"url":"https://api.proxidize.com/api/v1"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"http","scheme":"Bearer","in":"header","description":"Enter token as: Bearer <token>"}},"schemas":{"AccessPoint":{"type":"object","required":["username","password"],"properties":{"username":{"title":"Username","type":"string"},"password":{"title":"Password","type":"string"}}}}},"paths":{"/pergb/mobile/access-point":{"post":{"operationId":"pergb_mobile_access-point_create","description":"Create a new access point (sub-user) for the authenticated Per GB user","responses":{"200":{"description":"Access point created successfully","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"400":{"description":"Error creating access point or user already exists","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}},"tags":["pergb"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccessPoint"}}},"required":true}}}}}
```


# Residential - perGB API

Browse the REST API reference for Per GB Residential Proxies, including user info, settings, whitelisting, and access points.

To retrieve the "username"/"super\_user" fields from the response data, you can access the nested JSON structure. Here's how you can do it for both Python and JavaScript:

Both snippets assume there is at least one entry in the "data" array, indicating an active Per GB subscription. Ensure proper error handling for scenarios such as empty arrays or missing fields.

{% tabs %}
{% tab title="Python" %}

```python
import requests

url = "https://api.proxidize.com/api/v1/subscription?type=per_gb"

headers = {
    "Authorization": "Bearer <API_TOKEN>"
}

response = requests.get(url, headers=headers)
data = response.json()

# Response structure:
# {
#   "data": [
#     {
#       "meta_data": {
#         "username": "your-username"
#       }
#     }
#   ]
# }

print(data)
```

{% endtab %}

{% tab title="Javascript" %}

```javascript
const url = "https://api.proxidize.com/api/v1/subscription?type=per_gb";

const headers = {
  "Authorization": "Bearer <API_TOKEN>"
};

const response = await fetch(url, {
  method: "GET",
  headers: headers,
});

const data = await response.json();

// Response structure:
// {
//   "data": [
//     {
//       "meta_data": {
//         "username": "your-username"
//       }
//     }
//   ]
// }

console.log(data);
```

{% endtab %}
{% endtabs %}


# Locations (Per ISP)

Reference for listing Per GB Residential Proxy locations by ISP.

## GET /pergb/residential/locations-proxy

> List available residential proxy locations

```json
{"openapi":"3.1.1","info":{"title":"Proxidize","version":"1.0.0"},"servers":[{"url":"https://api.proxidize.com/api/v1"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"http","scheme":"Bearer","in":"header","description":"Enter token as: Bearer <token>"}}},"paths":{"/pergb/residential/locations-proxy":{"get":{"operationId":"pergb_residential_locations","description":"List available residential proxy locations","responses":{"200":{"description":"List of available residential locations","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"country":{"type":"object","properties":{"name":{"description":"Country name (e.g., 'USA')","type":"string"},"value":{"description":"Country filter value (e.g., '-co-USA')","type":"string"},"locations":{"type":"array","items":{"type":"object","properties":{"label":{"description":"Human-readable location label (e.g., 'Dallas, TX')","type":"string"},"value":{"description":"Location filter value (e.g., '-co-USA-st-TX-ci-Dallas')","type":"string"},"average_speed":{"description":"Average proxy speed in the location (kbps)","type":"number"},"country":{"type":"string"},"state":{"type":"string"},"city":{"type":"string"}}}}}}}}}}}},"400":{"description":"Error retrieving data from service","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}},"tags":["pergb"]}}}}
```


# ISP (Per Location)

Reference for listing available ISPs by location for Per GB Residential Proxies.

## GET /pergb/residential/carriers-proxy

> List available residential proxy carriers. Optionally filter by location

```json
{"openapi":"3.1.1","info":{"title":"Proxidize","version":"1.0.0"},"servers":[{"url":"https://api.proxidize.com/api/v1"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"http","scheme":"Bearer","in":"header","description":"Enter token as: Bearer <token>"}}},"paths":{"/pergb/residential/carriers-proxy":{"get":{"operationId":"pergb_residential_carriers_proxy","description":"List available residential proxy carriers. Optionally filter by location","parameters":[{"schema":{"type":"string"},"name":"location","in":"query","description":"Filter carriers by location","required":false}],"responses":{"200":{"description":"List of available residential carriers","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"country":{"type":"string"},"value":{"type":"string"},"available":{"type":"boolean"}}}}}}},"400":{"description":"Error retrieving data from service","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}},"tags":["pergb"]}}}}
```


# User Information

Reference for retrieving user information for Per GB Residential Proxies.

## GET /pergb/residential/user-info

> Get user information for the authenticated residential user

```json
{"openapi":"3.1.1","info":{"title":"Proxidize","version":"1.0.0"},"servers":[{"url":"https://api.proxidize.com/api/v1"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"http","scheme":"Bearer","in":"header","description":"Enter token as: Bearer <token>"}}},"paths":{"/pergb/residential/user-info":{"get":{"operationId":"pergb_residential_user_info","description":"Get user information for the authenticated residential user","responses":{"200":{"description":"User information","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"username":{"type":"string"},"password":{"type":"string"},"enabled":{"type":"boolean"},"bytes_used":{"type":"integer"},"bytes_available":{"type":"integer"},"super_user":{"type":"string"},"is_sub_user":{"type":"boolean"},"type":{"type":"string"},"byte_sum":{"type":"integer"},"is_kyc_verified":{"type":"boolean"},"is_crypto_payment":{"type":"boolean"}}}}}},"400":{"description":"Error retrieving data from service","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}},"tags":["pergb"]}}}}
```


# Settings

Reference for retrieving and updating settings for Per GB Residential Proxies.

## GET /pergb/residential/settings

> List all residential access-point settings for the authenticated user

```json
{"openapi":"3.1.1","info":{"title":"Proxidize","version":"1.0.0"},"servers":[{"url":"https://api.proxidize.com/api/v1"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"http","scheme":"Bearer","in":"header","description":"Enter token as: Bearer <token>"}}},"paths":{"/pergb/residential/settings":{"get":{"operationId":"pergb_residential_settings_read","description":"List all residential access-point settings for the authenticated user","responses":{"200":{"description":"List of residential access-point settings","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"access_point":{"type":"string"},"carrier":{"type":"string"},"city":{"type":"string"},"city_name":{"type":"string"},"country":{"type":"string"},"hostname":{"type":"string","enum":["dns","ip"]},"ip_mode":{"type":"string"},"proxy_type":{"type":"string","enum":["socks","http"]}}}}}}},"400":{"description":"Error retrieving data from service","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}},"tags":["pergb"]}}}}
```


# Whitelisting

Reference for whitelisting endpoints for Per GB Residential Proxies.

Use whitelisting to limit Residential proxy access to approved source IPs.

Whitelisting controls **who can connect**.

Country, city, and ISP control **where the proxy exits from**.

To add or update allowed IPs, use [IP Whitelist](/proxidize-rest-api/proxidize-api/residential-pergb-api/whitelisting/ip-whitelist).

### Format requirements

When you pass `country`, `city`, or `ISP`, use the values returned by the lookup APIs.

Use [Locations (Per ISP)](/proxidize-rest-api/proxidize-api/residential-pergb-api/locations-per-isp) to fetch valid country and city values.

Example response:

```json
[
  {
    "country": {
      "name": "Spain",
      "value": "-co-Spain",
      "locations": [
        {
          "label": "Adra, Andalusia",
          "value": "-co-Spain-st-Andalusia-ci-Adra",
          "country": "Spain",
          "state": "Andalusia",
          "city": "Adra"
        },
        {
          "label": "Aguadulce, Andalusia",
          "value": "-co-Spain-st-Andalusia-ci-Aguadulce",
          "country": "Spain",
          "state": "Andalusia",
          "city": "Aguadulce"
        }
      ]
    }
  }
]
```

Use:

* `country: Spain`
* `city: Adra`

### Get the correct ISP format

Use [ISP (Per Location)](/proxidize-rest-api/proxidize-api/residential-pergb-api/isp-per-location) with the `location` query parameter.

Then use the returned ISP `value`.

Example response:

```json
[
  {
    "name": "AS174 Cogent Communications, LLC",
    "country": "Spain",
    "value": "174",
    "available": true
  }
]
```

Use:

* `carrier: 174`

### Example

If you want Spain, Adra, Andalusia, and carrier AS174, use:

```
country=Spain
city=Adra
carrier=174
```


# IP Whitelist

Reference for the IP Whitelist endpoint for Per GB Residential Proxies.

## POST /pergb/residential/ip-whitelist

> Create IP whitelist entries for residential proxy access points

```json
{"openapi":"3.1.1","info":{"title":"Proxidize","version":"1.0.0"},"servers":[{"url":"https://api.proxidize.com/api/v1"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"http","scheme":"Bearer","in":"header","description":"Enter token as: Bearer <token>"}},"schemas":{"PerGBIPWhitelistCreate":{"type":"object","required":["access_point","super_user"],"properties":{"access_point":{"type":"array","items":{"type":"string"}},"super_user":{"title":"Super user","type":"string"},"session_key":{"title":"Session key","type":"string"},"country":{"title":"Country","type":"string"},"state":{"title":"State","type":"string"},"hostname":{"title":"Hostname","type":"string","enum":["dns","ip"]},"city":{"title":"City","type":"string"},"carrier":{"title":"Carrier","type":"string"},"proxy_type":{"title":"Proxy type","type":"string","enum":["socks","http"]}}}}},"paths":{"/pergb/residential/ip-whitelist":{"post":{"operationId":"pergb_residential_ip-whitelist_create","description":"Create IP whitelist entries for residential proxy access points","responses":{"201":{"description":"IP whitelist created successfully","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"count":{"type":"integer"}}}}}},"400":{"description":"Error retrieving data from service","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"409":{"description":"IP whitelist entry already exists for one or more IPs","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}},"tags":["pergb"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerGBIPWhitelistCreate"}}},"required":true}}}}}
```

## PUT /pergb/residential/ip-whitelist

> Update an existing residential IP whitelist entry

```json
{"openapi":"3.1.1","info":{"title":"Proxidize","version":"1.0.0"},"servers":[{"url":"https://api.proxidize.com/api/v1"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"http","scheme":"Bearer","in":"header","description":"Enter token as: Bearer <token>"}},"schemas":{"PerGBIPWhitelistUpdate":{"type":"object","required":["access_point","super_user"],"properties":{"access_point":{"title":"Access point","type":"string"},"super_user":{"title":"Super user","type":"string"},"session_key":{"title":"Session key","type":"string"},"country":{"title":"Country","type":"string"},"state":{"title":"State","type":"string"},"hostname":{"title":"Hostname","type":"string","enum":["dns","ip"]},"city":{"title":"City","type":"string"},"carrier":{"title":"Carrier","type":"string"},"proxy_type":{"title":"Proxy type","type":"string","enum":["socks","http"]}}}}},"paths":{"/pergb/residential/ip-whitelist":{"put":{"operationId":"pergb_residential_ip-whitelist_update","description":"Update an existing residential IP whitelist entry","responses":{"200":{"description":"IP whitelist updated successfully","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"400":{"description":"Error retrieving data from service","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"404":{"description":"IP whitelist setting not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"409":{"description":"IP whitelist entry already exists for one or more IPs","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}},"tags":["pergb"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerGBIPWhitelistUpdate"}}},"required":true}}}}}
```


# Access Point

Reference for the access point endpoint for Per GB Residential Proxies.

## GET /pergb/residential/access-point

> List all access points (sub-users) for the authenticated residential user

```json
{"openapi":"3.1.1","info":{"title":"Proxidize","version":"1.0.0"},"servers":[{"url":"https://api.proxidize.com/api/v1"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"http","scheme":"Bearer","in":"header","description":"Enter token as: Bearer <token>"}}},"paths":{"/pergb/residential/access-point":{"get":{"operationId":"pergb_residential_access-point_read","description":"List all access points (sub-users) for the authenticated residential user","responses":{"200":{"description":"List of residential access points","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"username":{"type":"string"},"password":{"type":"string"},"enabled":{"type":"boolean"},"bytes_used":{"type":"integer"},"bytes_available":{"type":"integer"},"super_user":{"type":"string"},"is_sub_user":{"type":"boolean"},"type":{"type":"string"},"byte_sum":{"type":"integer"},"is_kyc_verified":{"type":"boolean"},"is_crypto_payment":{"type":"boolean"}}}}}}},"400":{"description":"Error retrieving data from service","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}},"tags":["pergb"]}}}}
```

## POST /pergb/residential/access-point

> Create a new access point (sub-user) for the authenticated residential user

```json
{"openapi":"3.1.1","info":{"title":"Proxidize","version":"1.0.0"},"servers":[{"url":"https://api.proxidize.com/api/v1"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"http","scheme":"Bearer","in":"header","description":"Enter token as: Bearer <token>"}},"schemas":{"AccessPoint":{"type":"object","required":["username","password"],"properties":{"username":{"title":"Username","type":"string"},"password":{"title":"Password","type":"string"}}}}},"paths":{"/pergb/residential/access-point":{"post":{"operationId":"pergb_residential_access-point_create","description":"Create a new access point (sub-user) for the authenticated residential user","responses":{"200":{"description":"Residential access point created successfully","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"400":{"description":"Error creating residential access point or user already exists","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}},"tags":["pergb"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccessPoint"}}},"required":true}}}}}
```


# Proxy Builder (Legacy) API

Browse the legacy Proxy Builder API reference for server, modem, SIM, SMS, and agent tasks.

***


# Server

Reference for legacy Proxy Builder server endpoints.

{% openapi src="<https://cloud-django-static.s3.amazonaws.com/static/doc_schema.json>" path="/server" method="get" %}
<https://cloud-django-static.s3.amazonaws.com/static/doc_schema.json>
{% endopenapi %}

{% openapi src="<https://cloud-django-static.s3.amazonaws.com/static/doc_schema.json>" path="/server/{id}" method="get" %}
<https://cloud-django-static.s3.amazonaws.com/static/doc_schema.json>
{% endopenapi %}


# Modem

Reference for legacy Proxy Builder modem endpoints.

{% openapi src="<https://cloud-django-static.s3.amazonaws.com/static/doc_schema.json>" path="/modem" method="get" %}
<https://cloud-django-static.s3.amazonaws.com/static/doc_schema.json>
{% endopenapi %}

{% openapi src="<https://cloud-django-static.s3.amazonaws.com/static/doc_schema.json>" path="/modem/{id}" method="get" %}
<https://cloud-django-static.s3.amazonaws.com/static/doc_schema.json>
{% endopenapi %}


# SIM

Reference for legacy Proxy Builder SIM endpoints.

{% openapi src="<https://cloud-django-static.s3.amazonaws.com/static/doc_schema.json>" path="/sim" method="get" %}
<https://cloud-django-static.s3.amazonaws.com/static/doc_schema.json>
{% endopenapi %}

{% openapi src="<https://cloud-django-static.s3.amazonaws.com/static/doc_schema.json>" path="/sim/{id}" method="get" %}
<https://cloud-django-static.s3.amazonaws.com/static/doc_schema.json>
{% endopenapi %}


# Modem IP Logs

Reference for viewing modem IP logs in legacy Proxy Builder.

{% openapi src="<https://cloud-django-static.s3.amazonaws.com/static/doc_schema.json>" path="/modem-ip-log" method="get" %}
<https://cloud-django-static.s3.amazonaws.com/static/doc_schema.json>
{% endopenapi %}

{% openapi src="<https://cloud-django-static.s3.amazonaws.com/static/doc_schema.json>" path="/modem-ip-log/{id}" method="get" %}
<https://cloud-django-static.s3.amazonaws.com/static/doc_schema.json>
{% endopenapi %}


# Modem Token

Reference for retrieving modem tokens in legacy Proxy Builder.

{% openapi src="<https://cloud-django-static.s3.amazonaws.com/static/doc_schema.json>" path="/modem-token" method="get" %}
<https://cloud-django-static.s3.amazonaws.com/static/doc_schema.json>
{% endopenapi %}


# SMS

Reference for legacy Proxy Builder SMS endpoints.

{% openapi src="<https://cloud-django-static.s3.amazonaws.com/static/doc_schema.json>" path="/sms" method="get" %}
<https://cloud-django-static.s3.amazonaws.com/static/doc_schema.json>
{% endopenapi %}

{% openapi src="<https://cloud-django-static.s3.amazonaws.com/static/doc_schema.json>" path="/sms/{id}" method="get" %}
<https://cloud-django-static.s3.amazonaws.com/static/doc_schema.json>
{% endopenapi %}


# Agent Tasks

Reference for legacy Proxy Builder agent task endpoints.

***


# Change IP Interval

Reference for the Change IP Interval task in legacy Proxy Builder.

#### Understanding `on_prem_id`

The `on_prem_id` is an identifier retrieved from the "modem" endpoint. This unique ID is essential for various operations as it needs to be specified within the parameters object when making requests. It ensures that the actions executed are accurately targeted, particularly in environments with multiple on-premise devices. Always ensure that you use the correct `on_prem_id` to prevent any unintended changes.

{% openapi src="<https://cloud-django-static.s3.amazonaws.com/static/doc_schema.json>" path="/task/change-ip-interval" method="post" %}
<https://cloud-django-static.s3.amazonaws.com/static/doc_schema.json>
{% endopenapi %}


# Change IP

Reference for the Change IP task in legacy Proxy Builder.

#### Understanding `ids`

The `ids` is a list of `on_prem_ids` which are identifier retrieved from the `modem` endpoint. This unique ID is essential for various operations as it needs to be specified within the parameters object when making requests. It ensures that the actions executed are accurately targeted, particularly in environments with multiple on-premise devices. Always ensure that you use the correct `on_prem_id` to prevent any unintended changes.

{% openapi src="<https://cloud-django-static.s3.amazonaws.com/static/doc_schema.json>" path="/task/change-ip" method="post" %}
<https://cloud-django-static.s3.amazonaws.com/static/doc_schema.json>
{% endopenapi %}


# Send SMS

Reference for the Send SMS task in legacy Proxy Builder.

#### Understanding `ids`

The `ids` is a list of `on_prem_ids` which are identifier retrieved from the `sim` endpoint. This unique ID is essential for various operations as it needs to be specified within the parameters object when making requests. It ensures that the actions executed are accurately targeted, particularly in environments with multiple on-premise devices. Always ensure that you use the correct `on_prem_id` to prevent any unintended changes.

{% openapi src="<https://cloud-django-static.s3.amazonaws.com/static/doc_schema.json>" path="/task/send-sms" method="post" %}
<https://cloud-django-static.s3.amazonaws.com/static/doc_schema.json>
{% endopenapi %}


# Proxy Builder Platform Deprecation Notice

Understand the timeline and impact of the Proxy Builder platform deprecation.

## Effective June 3, 2026, Proxidize Proxy Builder is now considered a legacy platform.

The Proxy Builder platform has been deprecated and will no longer be maintained. This includes the Proxy Builder Cloud Dashboard, Linux Agent, Proxidize Android Agent, USB modem-based proxy creation, and related Proxy Builder workflows.

Proxy Builder is no longer offered to new customers.

***

### What This Means

Existing Proxy Builder customers can continue using the platform.

Customers with existing access can still:

* Access the Proxy Builder dashboard.
* Use their existing Proxy Builder setup.
* Renew their subscription.
* Upgrade or downgrade their subscription.
* Add or manage hosts and modems.
* Contact Proxidize Support if they run into any issues.

Nothing has changed for existing customers beyond the platform moving into legacy status.

***

### Updates and Maintenance

Proxy Builder is deprecated and will no longer be maintained.

No new feature updates, product improvements, platform updates, Linux Agent updates, Android Agent updates, or new USB modem-based proxy creation updates are planned for the Proxy Builder platform.

### Recommended Alternative

For new proxy needs, we recommend using Proxidize hosted proxy services instead of starting a new Proxy Builder setup.

Proxidize hosted proxy services are actively maintained and are the recommended option for customers who want a managed proxy experience without operating their own Linux server, USB modem setup, or local Proxy Builder infrastructure.

***

### Support Commitment

Proxidize remains committed to supporting its customers across all services.

If you are an existing Proxy Builder customer and run into an issue, our Support team will be happy to help.

***

### Need Help?

If you have any questions, concerns, or need further clarification, feel free to reach out to us via live chat or email us directly at <support@proxidize.com>.


# Proxy Builder

Learn how the legacy Proxy Builder platform works and find its core guides.

Proxy Builder is legacy documentation for existing users only.

Proxy Builder is no longer offered to new customers.

These pages remain available for older self-hosted deployments that still need setup, troubleshooting, or migration help.

If you are new to Proxidize, start with the managed cloud products instead:

* [Choose a Proxy Product](/getting-started/choose-between-mobile-and-residential-proxies)
* [Proxidize Proxies](/proxidize-proxies/mobile-proxies)
* [Proxidize Residential Proxies](/proxidize-proxies/residential-pergb)

If you are an existing user, start with:

* [How-to Guides](broken://spaces/iAQa47xivOtQQ7mQZOnQ/pages/83f1b8942301c82f0ce6ac2b7ccbd4fca614ee08)


# Getting Started

Start here for the legacy Proxy Builder basics, plans, and first setup steps.

Core setup and orientation for legacy Proxy Builder.


# Proxidize Proxy Builder (Legacy) Overview & How It Works

Understand how legacy Proxidize Proxy Builder works end to end.

Proxy Builder is legacy documentation for existing users only.

Proxy Builder is no longer offered to new customers.

If you are new to Proxidize, use the managed cloud products instead.

A complete guide to how the Proxidize Proxy Builder works, what it's made up of, and how to get started building and managing your own mobile proxy network.

### **What is Proxidize Proxy Builder?**

Proxidize Proxy Builder is a complete, end-to-end solution for building and managing your own 3G, 4G/LTE, and 5G mobile proxies, without relying on a third-party proxy provider.

Most proxy users rent access from providers, meaning they share infrastructure, have no control over uptime or quality, and are subject to someone else's pricing. Proxy Builder flips that model entirely. Rather than buying proxies from someone else, you build and own your proxy infrastructure using your own hardware. Your proxies, your network, your control, with full visibility into performance, costs, and scale.

Using your own hardware *(whether that's Android phones or a Linux-based server with USB modems)* you can have mobile proxies up and running in minutes, managed entirely from a cloud dashboard accessible from anywhere in the world.\
The platform is built to scale with you, so whether you're starting with a single phone or deploying hundreds of modems, the infrastructure grows with your needs.

**See it in action:**

***

### **What Can You Build With It?**

Proxy Builder currently supports two types of setups:

* **Android Agent:** Use Android smartphones as mobile proxy sources. Simple to set up, no additional hardware required beyond the phone and a SIM card.
* **Linux Agent:** Use a Linux-based server paired with USB LTE modems to create a scalable, high-capacity proxy network.

Both are managed through the same cloud dashboard, giving you a single place to monitor and control your entire proxy fleet.

***

### **How It Works**

#### Proxy Builder is made up of two core components: **hardware** and **software**.

**Hardware**

Depending on your setup, your hardware will be either:

* **Android phones** with active SIM cards, or
* **A Linux server** connected to a USB hub with multiple LTE modems

Each device or modem acts as an individual mobile proxy endpoint, using real cellular connections that are indistinguishable from regular mobile network traffic.

**Software**

**Cloud Router** The Cloud Router handles communication between your hardware and the Proxidize platform, no manual router configuration, no port forwarding, no ISP restrictions to work around. Your proxies connect through one of many globally distributed cloud routers, making them accessible from anywhere in the world.

![](/files/0d6b141d53f753d502a1d896fff4a554f0c2dbf6)

**Cloud Dashboard** The Cloud Dashboard is your central control panel for everything. From here you can:

* Monitor all connected devices and proxies in real time
* View detailed analytics and usage reports
* Configure and manage individual proxies or entire fleets
* Set up customizable alerts for device and connection events
* Rotate IPs, manage endpoints, and control proxy settings remotely

![](/files/c23960842a60a1b4ca42fbcbe7520806d86d4af8)

***

### **Plans & Pricing**

Proxy Builder plan details are kept for existing users who still need them.

See the archived breakdown on the [Proxidize Proxy Builder (Legacy) Platform Plans](/legacy-products/proxy-builder/getting-started/proxidize-proxy-builder-legacy-platform-plans) page.

***

### **Getting Started**

The fastest way to get started depends on your hardware:

* **Using an Android phone?** Start with the [Android Agent: Device Compatibility & Requirements](/legacy-products/proxy-builder/getting-started/android-agent-device-compatibility-and-requirements) article, then follow [Onboard an Android Device to Proxy Builder (Legacy)](/legacy-products/proxy-builder/setup-and-onboarding/onboard-an-android-device-to-proxy-builder-legacy).
* **Using a Linux server and modems?** Check [Linux Agent: System Requirements & Supported Modems](/legacy-products/proxy-builder/getting-started/linux-agent-system-requirements-and-supported-modems) before getting started.

If you need more legacy setup help, continue with [How-to Guides](broken://spaces/iAQa47xivOtQQ7mQZOnQ/pages/83f1b8942301c82f0ce6ac2b7ccbd4fca614ee08) or review the [Proxy Builder Platform Deprecation Notice](/legacy-products/proxy-builder-platform-deprecation-notice).

***

### Need Help?

If you have any questions, concerns, or need further clarification, feel free to reach out to us via live chat or email us directly at **<support@proxidize.com>**.


# Proxidize Proxy Builder (Legacy) Platform Plans

Review available plans for the legacy Proxidize Proxy Builder platform.

This page is archived for existing Proxy Builder users only.

Proxy Builder is no longer offered to new customers.

This page describes legacy plan details that may still help existing users understand older subscriptions and features.

Proxy Builder previously included three plan tiers:

* **Free**: Designed for proxy enthusiasts and hobbyists, with limited features.
* **Personal**: Ideal for small to medium enterprises.
* **Business**: Tailored for large enterprises with extensive proxy use cases.

Below is a table detailing the features available in each plan with their description:

![](/files/26b4cc93154e3d031ae7ae1201fa902877387e8a)

## Proxidize Features Description

* **Support**: Community support is support provided by other Proxidize users and potentially by Proxidize staff. This is completely voluntary support and response, while we provide full support to our Proxidize Business users via phone, email & premium live chat.
* **Automated HTTP(s) Proxy Creation**: The automated creation of an HTTP(s) proxy immediately once a device is connected.
* **User/Pass Authentication:** Authenticating your proxies via username and password.
* **Cloud Proxy Management Dashboard**: The ability to use the Proxidize Cloud Dashboard to manage and view your proxies.
* **Easy Export & Customize Proxy Format:** The ability to change the proxy format when copied
* **Cloud Router Bypass Port Forwarding:** The Proxidize Cloud Router allows you to bypass the need for port forwarding using our innovative Cloud Routers.
* **Router Allowed Ports:** The number of ports that the Cloud Router will open for you, per endpoint. Each phone or USB modem is counted as an endpoint.
* **Insertion Order Modem Index Locking:** The ability to set the modem index by the order of insertion. Where the earliest Connected modem will have the lowest available index.
* **Store & Read Proxy Logs:** The ability to store and read your proxy logs, containing information about websites visited for each request.
* **Enable/Disable Proxy logs:** The ability to enable to disable the proxy logging.
* **Manual Proxy Log Deletion:** The ability to delete your proxy logs manually.
* **Scheduled Proxy Log Deletion:** The ability to schedule the deletion of your proxy logs every X time interval.
* **Custom Proxy Start Port Value:** Set the value of the port from which your proxies want to start from. It only works on Linux devices when the Proxidize Cloud Router is turned off.
* **Customize Proxy Authentication:** The ability to change the default random username and password.
* **Rotation API via direct URL:** The ability to change your IP address using a direct rotation URL.
* **Read SMS:** The ability to read the SMS on your device. - Requires supported carrier & hardware.
* **Send SMS:** The ability to send SMS messages from your cloud dashboard. - Requires supported carrier & hardware.
* **SOCKs Proxy w/ UDP Support:** The ability to use SOCKS proxies with UDP support.
  * **Supported** only on the **Proxy Builder Business Plan**
  * Requires the use of the **Linux Gen 2 agent**
  * ![](/files/333fd308b976eeb9be1dd71a89353c603e4a0114) **Not supported** on Android agents across **any plan**
* **WiFi Backend/Split on Mobile Phones:** The ability to split the incoming connections on Android to come from the WIFI While the outgoing connection will still be sent out from the mobile data connection.
* **Bulk Actions (Rotate/Reboot):** The ability to change the IP or reboot endpoints in bulk.
* **Manual Proxy IP Rotation:** The ability to change the IP of an endpoint on click.
* **Automated Proxy IP Rotation:** The ability to automate the IP rotation every X time interval for each or all endpoints.
* **Customize Proxy DNS**: The ability to change the DNS server used by your proxies.
* **SIM Card Information:** The ability to view your SIM card information, such as ICCID or IMSI. - Requires a compatible device with default SMS handler permission enabled.
* **Reboot Host & Endpoint:** The ability to reboot an endpoint or a host. - Does not work on Android, except when the app is set to be a Device Owner.
* **Randomized Proxy IP Rotation:** The ability to add randomization rotation to the interval to be different for each endpoint. - This only applies to Linux for now.
* **Traffic, Speed & Bandwidth Analytics:** The ability to access the analytics page to view the devices uptime, heatmap, data used, bandwidth over time, and more.
* **Proxy Speed Measurement & Reporting:** The ability to test the connection speed on each of your endpoints, and schedule Automated speed tests every X time interval, to keep an accurate record.
* **Alerts via Discord, Telegram, Slack, & More:** The ability to receive custom alerts you create such as host down, endpoint disconnected, etc. And receive the alert on Email, SMS, Slack, Discord, Telegram, etc.
* **SMS Forwarding:** The ability to forward SMS messages to an API endpoint.
* **IP Address History:** The ability to store and retrieve the history of your IP address per endpoint.
* **Multiple Users on Account:** The ability to have multiple users on the same account with different permissions. -This feature is only free in the beta version.
* **Activity Logs:** The ability to monitor the activities of each user on your account.
* **IPv6 Support:** The ability to use IPv6 to create proxies automatically. Requires the country to support IPv4v6 deal stacking.
* **Proxy IP Authentication:** The ability to authenticate your proxies using a source IP address or IP range. This currently only works on the Linux agent when the Cloud Router is disabled.
* **Change TTL & MTU:** The ability to change the TTL and MTU values on your endpoints.
* **Passive OS Spoofing:** The ability to spoof your Passive OS Fingerprint, as detected by p0f, and similar tools. - Currently only supported on the Linux Agent
* **Physical Location Index Locking:** The ability to set the index of each modem on a USB hub to correlate with the physical number of the port on the USB hub. - Linux agent only with Proxidize official hardware.
* **USB Port Map:** The ability to view a visual map showing the location and status of each modem on your USB hub. - Linux agent only with Proxidize official hardware.
* **USSD:** The ability to send USSD commands from your dashboard. - Requires supported carrier & hardware.
* **Onboarding Expert Help:** Free expert onboarding call included. Onboarding rules apply.
* **Keep Alive Engine (Sticky IPs):** The ability to prevent the IPs from changing for much longer than usual. - Requires supported carrier & hardware.
* **Proxy Pooling (Round Robin):** The ability to create a single proxy that rotates through your modems with every new request based on a round-robin balancing.
* **Load Balancing (Proxy pools w/ least conn):** The ability to create a single proxy that rotates through your modems with every new request based on a round-robin based on the lowest load prioritization.
* **SIM PIN Control:** The ability to remove the PIN lock of your SIMs. - Requires supported hardware. Currently, only the Proxidize MX2 is supported.
* **Smart Power Controls:** The ability to connect to smart power adapters or extension cords and reboot different components directly from the Proxidize dashboard. - Linux Only
* **Delete All SMS Messages:** The ability to delete all the SMS messages on an endpoint. - Works on Linux & Android, but requires default SMS handler permission on Android.
* **Custom Endpoint Nickname:** The ability to give a custom name or "nickname" to each endpoint on your account.


# Android Agent: Device Compatibility & Requirements

Review Android Agent device compatibility and setup requirements.

Learn which Android devices are compatible with the Proxidize Android Agent, how to download the app, and what limitations to be aware of before getting started, including Android Go and Motorola Razr restrictions.

The Proxidize Android Agent works on **any Android smartphone running Android 7.0 or higher**. No specific device is required.\
If your phone meets the minimum OS version, you're good to go. Download the app on the [Google Play Store](https://play.google.com/store/apps/details?id=com.proxidize.proxidizeandroidagent).

{% hint style="info" %}
**Ready to set up?** Before starting, make sure you meet all the setup requirements outlined in the onboarding guide: [Onboarding a New Android Device Using the Proxidize Android Agent](/legacy-products/proxy-builder/setup-and-onboarding/onboard-an-android-device-to-proxy-builder-legacy)
{% endhint %}

***

## Known Limitations

### Motorola Razr

The Motorola Razr lineup is not supported. We recommend choosing a different Android device.

### Android Go Devices

Phones running **Android Go** *(The lightweight Android variant designed for low-end and mid-range hardware)* may encounter an issue during onboarding where the Proxidize Android Agent cannot be set as the default assistant app. This is a known limitation of Android Go itself, not the Proxidize app.

If you're affected by this, contact our support team and we'll get it resolved for you.

{% hint style="warning" %}
**iOS is not supported.** The Proxidize Android Agent is an Android-only application and is not available for iPhone or any iOS device.
{% endhint %}

***

## Need Help?

If you run into any issues during setup or have questions about device compatibility, our support team is available via live chat or by submitting a ticket.


# Linux Agent: System Requirements & Supported Modems

Review Linux Agent system requirements and supported modems.

This article covers everything your server and hardware need to be ready before installing the Proxidize platform on a Linux server. We recommend reviewing it before getting started to make sure your setup goes smoothly.

## Operating System

Proxidize runs on Linux only. The following are the only supported operating systems:

| OS              | Supported Versions     |
| --------------- | ---------------------- |
| Ubuntu          | 20.04 LTS or 22.04 LTS |
| Raspberry Pi OS | Raspberry Pi 5 only    |

{% hint style="warning" %}
Windows and other Linux distributions are **not currently supported**.
{% endhint %}

## Hardware Requirements

Your server should meet or exceed the following minimum specifications:

| Component | Minimum Requirement           |
| --------- | ----------------------------- |
| CPU       | Dual-core processor (x86\_64) |
| RAM       | 4 GB                          |
| Storage   | 32 GB available               |
| Network   | **Wired Ethernet (required)** |

{% hint style="warning" %}
Wi-Fi is not supported. The Proxidize Linux agent must be installed on a server connected via Ethernet. Running it over Wi-Fi will cause instability and unpredictable connectivity issues. If your server is currently on Wi-Fi, switch to a wired connection before proceeding.
{% endhint %}

**Running a larger setup?**\
For servers with 8 or more modems, we recommend 8 GB RAM. Storage needs will also grow depending on how many modems you're running and how long you retain logs.

### Required Accessories

* **Externally powered USB hub**\
  A powered hub is essential for connecting your USB modems. Unpowered hubs cannot reliably supply enough current to multiple modems simultaneously, which leads to dropped connections and modem instability. Do not skip this.

## Supported USB Modems

Proxidize routes proxy traffic through USB modems that connect directly to a mobile carrier's network via SIM card. All Huawei HiLink models are fully supported, along with most ZTE models. The specific supported models are listed below.

{% hint style="info" %}
Stick to 4G modems. 3G-only modems typically deliver just 10–30% of their advertised speeds, which makes for a poor proxy experience. We don't recommend them.
{% endhint %}

### Huawei Modems

* E3372h, E3372sE8372h, E8278
* E303h, E353h
* E3276, E3276s
* E3272
* E3131, E3531, E3351, E3251
* E392, E397, E398
* E323S, UML397, EC3372
* K5005, K5007, K5150
* W5101

### ZTE Modems

* MF861, MF831, MF832G, MF832u, MF832s, MF833
* MF827, MF826, MF79, MF75
* MF820, MF820D, MF820T, MF820S2
* MF880
* MF821, MF821D, MF821S2
* MF822, MF823, MF825, MF825C
* MF170, MF730M, MF667

## Picking the Right Modem for Your Region

Not all modems work everywhere. Different models support different cellular frequency bands, and using the wrong one for your region will result in weak signal or no connectivity at all.

| Region                             | Recommended Model                                                |
| ---------------------------------- | ---------------------------------------------------------------- |
| Europe, Africa, Asia (excl. China) | Huawei E3372h-153 or E3372h-320                                  |
| China                              | Huawei E3372h-607 *(also compatible with Europe, Africa & Asia)* |
| North & South America              | Huawei E3372h-510 or E3372h-511                                  |


# Setup & Onboarding

Set up hosts and devices, then complete the main onboarding tasks for legacy Proxy Builder.

Device and host onboarding for legacy Proxy Builder.


# Onboard an Android Device to Proxy Builder (Legacy)

Add an Android device to the legacy Proxy Builder platform.

{% hint style="warning" %}
Legacy Documentation Notice: This article applies to Android Agent and Proxy Builder (Legacy), legacy Proxidize products maintained for existing customers. New customers should use Proxidize Mobile Proxies or Residential Proxies.
{% endhint %}

## What is Android Agent (Legacy)?

Android Agent (Legacy) is an Android app used with Proxidize Proxy Builder, a legacy self-hosted platform maintained for existing customers. It allowed Android devices to be connected to the Proxidize Cloud Dashboard and managed as mobile proxy endpoints.

Download the app on the [Google Play Store](https://play.google.com/store/apps/details?id=com.proxidize.proxidizeandroidagent).

## Before You Begin

{% stepper %}
{% step %}

## Disable or uninstall any VPN applications

Running a VPN alongside the Android Agent will cause conflicts. Fully disable or uninstall all VPN apps before proceeding.
{% endstep %}

{% step %}

## Use only one SIM card, inserted in Slot 1

Only one SIM card should be in the device, placed in SIM Slot 1. Using Slot 2 or having multiple SIMs inserted can cause connectivity issues.
{% endstep %}

{% step %}

## Ensure you have a strong mobile signal

Proxy stability is directly tied to signal quality. A weak or unstable signal will result in an unstable proxy. Make sure you're in an area with good mobile coverage.
{% endstep %}

{% step %}

## Grant all required app permissions

The Android Agent requires all permissions to function correctly. Any denied permission will cause issues during onboarding or proxy usage.
{% endstep %}

{% step %}

## Turn off Wi-Fi and use mobile data only

Before starting the onboarding process, disable Wi-Fi and make sure mobile data is active. If Wi-Fi is left on, you'll see a prompt asking you to switch to mobile data. Skipping this may cause the app to get stuck on the "Creating Host" screen.
{% endstep %}

{% step %}

## Make sure your SIM has an active data plan

The app requires a working mobile data connection. If there is no data on your SIM, the app will close immediately.
{% endstep %}
{% endstepper %}

## Onboarding Steps

{% stepper %}
{% step %}

## Log in

1. Open the Proxidize Android Agent app.\
   💡 Tap **"How to Start?"** on the welcome screen, this will guide you through linking your device to your dashboard.
2. Alternatively, Go to [app.proxidize.com](https://app.proxidize.com/), sign in, and find your **PIN** and **QR code** in the top-right corner of the dashboard.
3. In the app, enter the PIN (case-sensitive) or scan the QR code to proceed.

{% hint style="warning" %}
⚠️ **Important:** The PIN and QR code expire after **3 minutes**. Make sure you complete this step and enter your device nickname before they expire. If they expire, you will need to restart the app and repeat the process from the beginning.
{% endhint %}

![](/files/d23fb2c3ce4af1481bce642c2059c0b7d4c492d9)
{% endstep %}

{% step %}

## Register Your Device

Enter a nickname for your device. This is the name that will appear on your cloud dashboard to identify this phone.

![](/files/40ef5f64aedde2e0d174af8f4f70ff4aadaec282)
{% endstep %}

{% step %}

## Grant Permissions

You will be presented with a list of permissions to enable. **Grant all permissions** to ensure full functionality.

![](/files/1b615328d2671478849ceb3b20169949f55327d9)
{% endstep %}

{% step %}

## Creating Your Host

A loading screen will appear while the app sets up your host and endpoint. This takes a few moments, do not close the app during this step.

![](/files/2ab6f665517a61ef76b4eaa6094d9a5c25ce09fd)
{% endstep %}

{% step %}

## Connect

Tap the **Connect** button to begin the connection process. The app will connect your proxies and link to the router.

![](/files/6201bf7f9c3ad587bb3b83a3ae2527b8eb8f586a)

Once the **Connected** screen appears, your device is successfully onboarded.

![](/files/d0d9e038792cda262349445dfc61fc2485050446)
{% endstep %}
{% endstepper %}

## After Onboarding

* Your device will appear under the **Hosts** tab on your cloud dashboard.\
  ![](/files/af3404b9485a25f1600767aaf8b57f80ae92b9fc)
* Your proxies will be available under the **Endpoints** tab (expand your endpoint row) or under the **Proxies** tab.\
  ![](/files/000d1d88f9fcbb8a818f2d45bdd2a81abda9b856)
* Copy your proxy details from there and use them wherever needed.
* Your proxy credentials can be found in the **Host Settings** under the **Endpoints** tab.

## General Notes

* **Do not enable Wi-Fi** while the app is running unless you have the **Wi-Fi Backend** feature enabled. Enabling Wi-Fi without this feature will prevent the app from syncing with the dashboard. If this happens, restart the app and reconnect.
* If the app gets stuck on the **Creating Host** screen, restart the app and repeat the onboarding process from Step 1.

## Need Help?

If you run into any issues during setup or have questions about device compatibility, our support team is available via live chat or by submitting a ticket.


# Linux Agent: Onboarding and Offboarding Hosts

Onboard and offboard hosts with the Proxidize Linux Agent.

Learn about how to add or remove hosts from your Proxidize cloud dashboard.

## Installation

{% stepper %}
{% step %}
Once you have an external monitor connected to the server using an HDMI cable, you'll be presented with the following screen shown in the image below, after which you need to start the onboarding of your host by navigating to the “All applications menu”

![Onboard1](/files/a1070472729fbad20886b283e14200ff568d4da6)
{% endstep %}

{% step %}
Type “Terminal” on the search field and we open the Terminal app.

![image](/files/8b48d64770226be9b98382d676bd7e16c9bf7d55)
{% endstep %}

{% step %}
Type the following command: `sudo su` and enter the user password.
{% endstep %}

{% step %}
Type the following command: `curl -fsSL [pxfile.com/install\_cloud](http://pxfile.com/install%5Fcloud) | bash`

The installation process should start, once the installation process is finished, we get an IP address and we access it from the browser.

![Onboard3](/files/790487404523baf303c672ebf6832a06ffebc332)
{% endstep %}

{% step %}
Visit the IP presented to continue setting up your host
{% endstep %}
{% endstepper %}

## Onboarding your host (basic)

{% stepper %}
{% step %}
Once you are have entered the IP of your server, you'll see the login page of the Proxidize Cloud Platform, at which you need to enter the default credentials (admin:admin)

![Onboard4](/files/c9cd53b0a15a059dd7e1a65166d6356cb435ac6e)
{% endstep %}

{% step %}
You will be presented with a EULA agreement that contains the terms of use applicable to all Proxidize software.

![Onboard5](/files/c197bec4eaa6d4c569cc0aa98a9b11015a6d1207)
{% endstep %}

{% step %}
After reading the terms and conditions of the EULA you will need to confirm that you have read and accepted the terms and conditions of the EULA.

![Onboard6](/files/8a2864c1f2b923dd582b7d68257ad8a35846ea2c)
{% endstep %}

{% step %}
Next, you will be asked to change the default password for security reasons.

![Onboard7](/files/c47396724d3d5ac4771a431e791edf36d63c68e6)
{% endstep %}

{% step %}
Sign-in using your Proxidize account on the Proxidize cloud app at [https://www.app.proxidize.com](http://pxfile.com/install%5Fcloud) where you'll be able to find the pin on your Proxidize Cloud app dashboard.

![Onboard8](/files/3b5e213d2eafe456cb023401ab51a699e19922fa)
{% endstep %}

{% step %}
You will be asked to give the configured host a nickname and to enter the PIN mentioned in step 6.

![Onboard9](/files/94c3a045598150a11170f7b5b1ddc9dfa4da7de0)
{% endstep %}

{% step %}
To configure a static IP for this host, you can tick the static IP checkbox, which will ask you for your default gateway's IP (router IP) and the IP you want to reserve for your host.
{% endstep %}

{% step %}
Visit the Proxidize cloud app to verify the onboarding process

![image (1)](/files/e159bbabb03eb46f2642f9e667c5a0926056ad79)
{% endstep %}
{% endstepper %}

## Onboarding your host (advanced)

{% stepper %}
{% step %}
If you’re onboarding your host with a static IP, check the static IP option

![image (2)](/files/8992e800743f40fd77f84ea1996ad696ffa7c72d)
{% endstep %}

{% step %}
Use the command `ip r` to get the name of your network interface name

![image (3)](/files/c40561f79f7d35a664724bf2fc1e1bb3d1e145b1)
{% endstep %}

{% step %}
Fill in the network interface name along with your host IP address, default gateway (router) and the DNS server IP address (default 8.8.8.8)

![image (4)](/files/cd6fe90d8a94f26670f90535bbe27d0011eab322)
{% endstep %}
{% endstepper %}

## Offboarding your host

{% stepper %}
{% step %}
Visit the Proxidize cloud app
{% endstep %}

{% step %}
Navigate to Dashboard, and then the hardware tab, where you will be able to see the hosts option.
{% endstep %}

{% step %}
Locate the offboard button (bin icon)

![image (5)](/files/dab30deb369bf0727d6391d26296f764f075989a)
{% endstep %}

{% step %}
Your host should be offboarded now.

![image (6)](/files/cd1b9e9686286cd1f3d5b073ffff9feb7b792909)
{% endstep %}
{% endstepper %}


# Recommended Mobile ISPs

See which mobile carriers work best with Proxidize mobile proxy setups.

## Learn if the mobile carrier you're purchasing the SIM from can work with the Proxidize Cloud Platform.

The best mobile carrier and/or SIM card provider is the one that works best in your area, therefore we recommend obtaining SIM cards from the carrier with the best signal reception for you.

If you're unsure which carrier is best for you, temporarily test multiple SIM cards from different carriers to find the one with the strongest signal. This approach ensures optimal performance when using your mobile proxies.

For users in the United States using USB modems, please note that a hotspot plan is required for proper functionality.

### Carriers We Do Not Recommend:

* **Verizon (United States):** Verizon SIM cards are incompatible with USB Modems. However, they should have no issues with Android phones.
* **Vodafone (UK) and Telstra (Australia):** Users have reported issues with mobile proxies not changing IPs when using these carriers.


# Hardware

Reference the supported servers, hubs, modems, hardware requirements, and compatibility notes.

Hardware docs for legacy Proxy Builder.


# Proxidize MX2 Modem

Learn about the Proxidize MX2 Modem and its hardware role.

## Proxidize MX2 modems features and specifications

The Proxidize MX2 USB modem is a premium flagship modem that combines speed, dependability, and user-friendliness in one unit. This modem's 4G LTE CAT 5 capabilities provide download and upload rates of up to 150/50 Mbps, making it an excellent option for enterprises that must move huge volumes of data quickly. However, the speed will highly depend on the cellular network performance of the premises.

Proxidize MX2 is distinguished by its perfect interaction with the Proxidize system. This means that this modem can be installed in a matter of minutes, without any complicated configuration procedures or compatibility difficulties. The Proxidize MX2 makes it easy to connect and you can even get the SIM cards pre-inserted using the Proxidize CONNECT plan (available in select countries).

The Proxidize MX2 USB modem is the ideal answer if you're searching for a modem that provides fast and dependable cellular connectivity, along with simple integration and deployment. This modem is a sensible solution for organizations that need powerful and stable mobile proxies, regardless of whether you're upgrading your existing infrastructure or starting from scratch.

#### Models:

1. MX2-ROW model for Europe, Asia, Africa and Oceania
2. MX2-NSA model for the North America and South America

#### MX2 Modem Package Contents:

1. MX2 Modem
2. Pre-inserted SIM Card (Optional)

#### Features:

1. Instant integration with all Proxidize equipment & systems
2. 4G LTE CAT 4 Sped up to 150/50 Mbps links
3. Nano SIM card port via locking mechanism
4. Multiple models to support any country
5. Year International Warranty

![](/files/aed4ca15dcb0aedc06f73cf717f83df281668812)

To insert SIM cards into the MX2 modem, you need to:

1. Open the MX2 modem by sliding the back panel while applying pressure.
2. As in the below picture, apply down pressure on the metal plate that holds the SIM card in place and slide it open along the direction shown in Figure 1 in the picture.
3. Insert the SIM card as shown in Figure 2 in the picture and make sure that the SIM card is oriented correctly to match the shown in Figure 2.
4. Hold the SIM in place by sliding the metal plate reversely on it, as shown in Figure 3 in the picture.

![MX2-SIM-1](/files/d906f0da5b457064a009b88d0ed4c7da716f10dc)


# Proxidize SX2 Microserver

Learn about the Proxidize SX2 Microserver and its hardware role.

## Proxidize SX2 micro server features and specifications.

The Proxidize SX2 Micro Server is a robust and compact Proxidize host machine. With the capacity to support up to 20 USB modems and a network bandwidth of 1 Gbps, it is the ideal solution for people who need dependable and efficient mobile proxies.

This server is a fundamental component of the Proxidize mobile proxy system as it powers every Proxidize 20-modem kit and can be used to build 4G LTE or 5G mobile proxy networks, making it a versatile and indispensable tool, especially for smaller businesses. Regardless of the complexity of your use case, the Proxidize SX2 Micro Server provides everything you require.

### Models:

1. SX2-ROW model for Europe, Asia, Africa and Oceania
2. SX2-NSA model for the North America and South America

### SX2 Micro Server Package Contents:

1. SX2 Micro Server
2. Ethernet Cable
3. Power Adapter
4. User Manual

### Features:

1. Instant integration with all Proxidize equipment & systems
2. Supports up to 20 USB modems
3. Network speed of up to 1 Gbps
4. 1 Year International Warranty

![](/files/3082702ce6e3a3df4eae914c2447644dd5259506)

### How to set up your Proxidize SX2 Microserver:

{% stepper %}
{% step %}

## Take everything out of the box and packaging

Proxidize Kits come with a lot of packaging material to protect the hardware during international shipping.

The first thing you need to do once you have the package is to take everything out of its packaging.

![Getting Started with Proxidize, SX2 One](/files/7ded68d31e34a04d70541c156e071b192d50ae92)
{% endstep %}

{% step %}

## Connect the Ethernet cable to your router and to the Proxidize SX2 Server.

Every Proxidize kit comes with an Ethernet cable. You need to use this cable to connect the Proxidize Server to the internet by connecting one side of the cable to the Proxidize Server and the other side to your router.

![Getting Started with Proxidize, SX2 Two](/files/8b8d960e1891ca5066a20e1b0bef58f663978614)
{% endstep %}

{% step %}

## Connect the USB hub to the Proxidize SX2 Server via the USB cable

Every Proxidize kit comes with an HX1 USB hub and a USB cable. We need the hub to connect the MX2 USB modems to the SX2 Server. The Proxidize Server has 3 USB ports. **It does not matter which port you use.**

**Please ensure the power switch on the rear of the hub is set to off.**

![Getting Started with Proxidize, SX2 Three](/files/a637304ebc946a564a9656e1bc55c2edc4a65ac1)
{% endstep %}

{% step %}

## Insert your SIM cards into the MX2 USB modems.

Please pay close attention here: You'll need to use **Nano-size** SIM cards for the Proxidize modems. If your sim card is not Nano-size, please remove the extra adapter layer to convert it to Nano-SIM.

This step is optional for the installation. If you don’t have the SIM cards now, you can add them later, but please keep in mind the proxies won’t work unless your SIM cards are connected properly and have data.

![Getting Started with Proxidize, SX2 Four](/files/fc7e298f6be2ebe56a64175f3ecb1e6916266315)
{% endstep %}

{% step %}

## Connect your MX2 modems to the USB hub.

This is very simple. All you have to do is insert the USB modems into the USB hub ports.

![Getting Started with Proxidize, SX2 Five](/files/7a9f446fe89baf84fa304770926905714d81ed08)
{% endstep %}

{% step %}

## Connect the power adapters to power sockets

Once you reach this step, you need to connect the adapters to power.

Please note every kit has 2 or more plugs. There will always be one plug for the Proxidize SX2 Server and one plug for every hub you have. These plugs are different so please do not connect them before reading the next step.

**Note: If you do not have a correct adapter at the moment, please do not try to use any charger you have as that can damage the hardware and void your warranty. We recommend not connecting the hardware to power until you have the correct socket adapters.**

![Getting Started with Proxidize, SX2 Six](/files/38c13923be2b7f837e5581c40e9d7458d34714f9)
{% endstep %}

{% step %}

## Connect the hardware to power

Now we need to connect the 5-Volt-rated power adapter to the Proxidize Server and the 12-Volt-rated power adapter to the USB hub.

Both the SX2 Server and the HX1 USB hub have a 5.5 mm input port, so please pay close attention to the power adapters as it would be easy to mix them up.

![Getting Started with Proxidize, SX2 Seven](/files/64084f1cbbd409597b6e469ab11d382d010c2194)
{% endstep %}
{% endstepper %}

Once you have your hardware set up and ready, please refer to the following articles to install the Proxidize Cloud platform and onboard your new server to your Proxidize Cloud dashboard.

[https://help.proxidize.com/en/offboarding-and-onboarding-hosts](broken://pages/855fc09941f7f88a5a026314171284f0e955d554)

If you face any issues or have any questions regarding the kit setup or the onboarding of the device, feel free to reach out to our support team if you have a Proxidize Business plan using the small pop-up at the bottom right of your screen, or reach out to our [community](https://community.proxidize.com/).


# Proxidize SX4 Mini Server

Learn about the Proxidize SX4 Mini Server and its hardware role.

## Proxidize SX4 server features and specifications

The Proxidize SX4 Mini Server is a small and potent Proxidize host server used for building a dependable and fast 4G LTE or 5G mobile proxy network. This server supports up to 80 USB modems and has a network speed of 2.5 Gbps, making it perfect for running bigger proxy farms.

The Proxidize SX4's compact size makes it ideal for enterprises that need to maximize server space or put servers in confined areas such as standard desks, data centers, or server cabinets. This server provides exceptional performance despite its modest size, guaranteeing that your proxy usage remains consistent and uninterrupted.

The Proxidize SX4 is also created to be user-friendly. As part of the Proxidize mobile proxy system, it connects smoothly with other Proxidize components to enable the creation of a scalable and simplified on-premise mobile proxy solution.

In conclusion, the Proxidize SX4 Mini Server is a stable and high-performance solution for enterprises seeking to build a 4G LTE or 5G mobile proxy network. With its compact design, user-friendliness, and exceptional performance, it is an excellent option for enterprises wishing to enhance their existing infrastructure or construct a brand-new one.

### Models:

1. SX4-ROW model for Europe, Asia, Africa and Oceania
2. SX4-NSA model for the North America and South America

### SX4 Server Package Contents:

1. SX4 Mini Server
2. Power Adapter
3. Ethernet Cable
4. User Manual

### Features:

1. Instant integration with all Proxidize equipment & systems
2. Supports up 80 USB modems
3. Network speed of up to 2.5 Gbps
4. Year International Warranty

![](/files/ae952f1ad04e24c7be33c4c727857680fe9315d4)

## How to set up your Proxidize Sx4 Mini Server

{% stepper %}
{% step %}

### Take everything out of the box and packaging

Proxidize Kits come with a lot of packaging material to protect the hardware during international shipping.

The first thing you need to do once you have the package is to take everything out of its packaging.

![Getting Started with Proxidize, SX4 One](/files/4eaf68ee594f565ac9669d2dfdb6854c8b18ce5c)
{% endstep %}

{% step %}

### Connect the Ethernet cable to your router and to the Proxidize SX4 Server

Every Proxidize kit comes with an Ethernet cable. You need to use this cable to connect the Proxidize Server to the internet by connecting one side of the cable to the Proxidize Server and the other side to your router.

![Getting Started with Proxidize, SX4 Two](/files/f06e6c3be35e30ec313cec64329f0640be0ef1d9)
{% endstep %}

{% step %}

### Connect the USB hub to the Proxidize SX4 Server via the USB cable

Every Proxidize kit comes with an HX1 USB hub and a USB cable. We need the hub to connect the MX2 USB modems to the SX4 Server. The Proxidize Server has 6 USB ports ( 4 rear ports and 2 front ports). **You will need to use the rear ports only**.

**Please ensure the power switch on the rear of the hub is set to off.**

![Getting Started with Proxidize, SX4 Three](/files/fd7ee074edc13a12fcaf4dab5c3c0e99ead71dce)
{% endstep %}

{% step %}

### Insert your SIM cards into the MX2 USB modems

Please pay close attention here: You'll need to use **Nano-size** SIM cards for the Proxidize modems. If your sim card is not Nano-size, please remove the extra adapter layer to convert it to Nano-SIM.

This step is optional for the installation. If you don’t have the SIM cards now, you can add them later, but please keep in mind the proxies won’t work unless your SIM cards are connected properly and have data.

![Getting Started with Proxidize, SX4 Four](/files/708981800d738d35af4da5e7c288e8a7b88a5e14)
{% endstep %}

{% step %}

### Connect your MX2 modems to the USB hub

This is very simple. All you have to do is insert the USB modems into the USB hub ports.

![Getting Started with Proxidize, SX4 Five](/files/78c1aeed984b966405f33fd334195eea039a2c9d)
{% endstep %}

{% step %}

### Connect the power adapters to power sockets

Once you reach this step, you need to connect the adapters to power.

Please note every kit has 2 or more plugs. There will always be one plug for the Proxidize SX4 Server and one plug for every hub you have. These plugs are different, so please only connect them after reading the next step.

**Note: If you do not have a correct adapter at the moment, please do not try to use any charger you have as that can damage the hardware and void your warranty. We recommend not connecting the hardware to power until you have the correct socket adapters.**

![Getting Started with Proxidize, SX4 Six](/files/309a95829998e92962aa5128a1d0ce8a00b2a96f)
{% endstep %}

{% step %}

### Connect the hardware to power

Now we need to connect the 5-Volt-rated power adapter to the Proxidize Server and the 12-Volt-rated power adapter to the USB hub.

Both the SX4 Server and the HX1 USB hub have a 5.5 mm input port, so please pay close attention to the power adapters as it would be easy to mix them up.

![Getting Started with Proxidize, SX4 Seven](/files/72b32592e9c3779a9667b520703a72a6e80c1640)
{% endstep %}
{% endstepper %}

Once you have your hardware set up and ready, please refer to the following articles to install the Proxidize Cloud platform and onboard your new server to your Proxidize Cloud dashboard.

[https://help.proxidize.com/en/offboarding-and-onboarding-hosts](broken://pages/855fc09941f7f88a5a026314171284f0e955d554)

If you face any issues or have any questions regarding the kit setup or the onboarding of the device, feel free to reach out to our support team if you have a Proxidize Business plan using the small pop-up at the bottom right of your screen, or reach out to our [community](https://community.proxidize.com/).


# Proxidize HX1 Industrial 20-Ports USB Hub

Learn about the Proxidize HX1 Industrial USB Hub and its hardware role.

## Proxidize HX1 hub features and specifications

The Proxidize HX1 USB Hub is designed for industrial use as part of the Proxidize mobile proxy system. This 20-port USB 2.0 hub offers high-speed data transfer of up to 480 Mbps, making it ideal for hosting the Proxidize USB modems. With its rugged design, the Proxidize HX1 USB Hub can handle the demands of industrial environments, providing reliable and efficient connectivity for up to 20 USB modems. This hub allows you to easily connect and manage your Proxidize modems.

With its compact design and support for mounted rails, the Proxidize HX1 USB Hub can be installed in any place, be it a home, office, or even a data center. Whether mounted or seated, the HX1 Hub will be able to perform in any environment.

### Models

1. HX1-ROW model for Europe, Asia, Africa and Oceania
2. HX1-NSA model for North America and South America

### Package Content

1. HX1 USB Hub
2. Power Adapter
3. USB Cable

### Features

1. Instant integration with all Proxidize equipment & systems
2. Industrial and compact design
3. 12 months international warranty
4. Up to 20 USB devices
5. Up to 480 Mbps data rate

![](/files/c3f4346cbfef2c5993562e3321d9acabe9b25323)


# Proxidize RSX1 Rack Server

Learn about the Proxidize RSX1 Rack Server and how it fits into Proxy Builder.

## Proxidize RSX1 server features and specifications

The Proxidize RSX1 Rack Server is the perfect solution for businesses, enterprises and organizations looking to create and manage large numbers of on-premise mobile proxies. With its powerful hardware, 10 Gbps NIC, and easy installation, this server is designed to handle up to 200 modems with ease, making it ideal for creating and maintaining a reliable and scalable mobile proxy network.

This server features a compact but powerful 2U form factor, making it a space-efficient choice for any data center or server room. It is powered by a high-performance processor and has ample memory and storage capacity to support all possible use cases.

With the Proxidize RSX1 Rack Server, you can easily create and maintain a robust and reliable mobile proxy network that can handle even the most demanding workloads. Designed from the ground up to be a mobile proxy host. Nothing comes close to the power and versatility of the Proxidize RSX1 2U Rack Server. Upgrade today and take control of your mobile proxy infrastructure and scale up like you've never been able to do before!

### Models:

1. RSX1-ROW model for Europe, Asia, Africa and Oceania
2. RSX1-NSA model for the North America and South America

### RSX1 Server Contents:

1. RSX1 Server
2. Power Cable
3. Rack Cabinet \[Optional]
4. Rack Rails \[Optional]
5. Rack Tray \[Optional]

### Features:

1. Instant integration with all Proxidize equipment & systems
2. Supports up to 200 USB modems
3. Up to 10 Gbps network speed
4. Year International Warranty

![](/files/7d5cea32f5a86fabd9be2372f8637f949cf3d8f9)




---

[Next Page](/llms-full.txt/1)

