Overview
Traditional IP whitelisting requires static IP addresses, which can be limiting in dynamic environments. To offer more flexibility and security, we've introduced dynamic IP whitelisting via API. This streamlined solution eliminates the need for username/password authentication or frequent manual IP updates—making it easier than ever to manage access while maintaining robust protection.
Use Dynamic IP Whitelisting
Users commonly report the following challenges:
Dynamic IPs that change frequently (e.g., every 24 hours).
Software limitations preventing use of username/password authentication.
Hitting the whitelist limit (e.g., 800 IPs already added).
Requests to use DNS entries (e.g., domain name that resolves to a dynamic IP).
Desire for automation through an API-driven solution.
Benefits of the Dynamic IP Whitelisting API
Automate IP whitelisting without logging in.
No need to switch to username/password proxies.
Set custom expiration times for added IPs.
Supports labeling and management of entries.
API Guide
You can use the following API endpoints to manage your IP whitelist dynamically.
Add a Custom IP to Whitelist
curl -v -x <http://USERNAME:[email protected]:9000> \\ api.proxyrack.net/v1-beta/ip-whitelist \\ -d '{"ip": "209.205.202.186", "label":"testip", "expireTime":"7777"}'
ip: IP address to whitelist.label: Optional label for easy identification.expireTime: Can be in seconds, ISO format, or Unix timestamp.
Add Your Current IP Automatically
If you omit the ip field, your current IP will be whitelisted:
curl -v -x <http://USERNAME:[email protected]:9000> \\ api.proxyrack.net/v1-beta/ip-whitelist \\ -d '{"label":"testip", "expireTime":"7777"}'
List Whitelisted IPs
curl -v -x <http://USERNAME:[email protected]:9000> \\ api.proxyrack.net/v1-beta/ip-whitelist
Delete a Whitelisted IP
To remove a specific IP, use its unique ID:
curl -v -X DELETE -x <http://USERNAME:[email protected]:9000> \\ api.proxyrack.net/v1-beta/ip-whitelist/{UNIQUE_ID}
About expireTime
You can specify expiration in three ways:
As seconds (e.g.,
"expireTime": "86400"for 24 hours),As a Unix timestamp,
As an ISO date (e.g.,
"2025-06-30T15:00:00Z").
Best Practices
Set a reasonable
expireTimeto avoid stale entries.Use meaningful
labelvalues for easy management.
Need Help?
If you encounter issues using the API or have special cases, reach out to our support team with the following:
Your username.
The issue you're facing.
Example API requests (with sensitive info redacted).