IP Version

Learn how to filter Residential Proxies by their Internet Protocol version to receive only IPv4 or IPv6 proxies.

By default, our Residential Proxies include both IPv4 and IPv6 addresses. If needed, you can select the Internet Protocol (IP) version to receive only IPv4 or IPv6 proxies.

To enable this feature, contact your Account Manager (details available in the Dashboard). You may need to complete a quick KYC procedure.

Usage

Add the ipversion parameter to your username string to specify the IP version. It works alongside other parameters.

• ipversion-4 selects proxies from the IPv4 pool

• ipversion-6 selects proxies from the IPv6 pool

For example, if you want to receive only IPv6 proxies, your username string should be: customer-USERNAME-ipversion-6. Here's a complete cURL example:

curl -x pr.oxylabs.io:7777 -U "customer-USERNAME-ipversion-6:PASSWORD" https://ip.oxylabs.io/location

Residential Proxies are dynamic, so we cannot guarantee availability when combining the IP version with specific locations (e.g., city, ZIP).

If the target website does not support a specific IP version, our system will resolve the supported IP version where possible. For example, if you use the "IPv6 only" parameter with a website that only supports IPv4, the proxy may automatically resolve the target using IPv4 instead.

Reach out to your Account Manager to skip the automatic resolution and restrict the IP version to the selected one.

Error handling

If the target website does not support IPv6 you have disabled automatic resolution, you will receive a 522 error code. In that case, switch to IPv4 for the specific website or remove the ipversion parameter altogether.