Skip to main content
All CollectionsSoftware tutorials API
Whitelist your IP via the API method
Whitelist your IP via the API method
Vladislav avatar
Written by Vladislav
Updated over a week ago

In this article, we will talk about a method aimed at automating the work by adding an IP to the Whitelist of your package or changing a previously associated IP. This is especially useful if you have a dynamic IP or you intend to work with proxies from different, constantly changing devices.

As a reminder, whitelisting your IP is required to get access to proxies when using IP authorization. You are not required to whitelist your IP when using login and password authorization. In this case, Any IP mode will be automatically enabled for your package.

Any IP mode weakens the security measures used to protect your account, meaning that anyone in possession of your username and password will be able to access your subscription. Therefore, we recommend whitelisting your IP to ensure the maximum safety of your account. In this case, both authorization methods will only work if you use a whitelisted IP address.


You can use API through cURL requests or using Postman. Please don't hesitate to use this documentation for import into the Postman interface.

Methods for cURL requests for Windows 10 and iOS/Linux (the setting is described here).
The methods use the following variables:

  • <api-key> - an individual API key available in the "Profile" tab in your Dashboard.

  • <package-key> - the package login in the Whitelist, of which you need to make changes.

Get information about all available slots in the package

For Windows 10:

curl --location --request GET "https://partner.api.soax.com/v1/account/package/<package-key>/ip-list" --header "api-key: <api-key>"

For iOS/Linux:

curl --location --request GET 'https://partner.api.soax.com/v1/account/package/<package-key>/ip-list?=' \--header 'api-key: <api-key>'

In response to the request, you will receive information on each of the slots in the format:

slot IP address, slot name, slot number.


Update the IP address in the available slots

New variables appear in this request:

  • <slot_IP> - IP to be pinned to the slot;

  • <slot_number> - number of the slot to be changed

  • <slot_name> - the name of the slot to be changed.

For Windows 10:

curl --location --request POST "https://partner.api.soax.com/v1/account/package/<package-key>/update-ip?=" --header "api-key: <api-key>" --header "Content-Type: application/json" --data-raw "[{\"ip\": \"<slot_IP>\", \"slot\": <slot_number>,\"comment\": \"<slot_name>\"}]"

For iOS/Linux:

curl --location --request POST 'https://partner.api.soax.com/v1/account/package/<package-key>/update-ip?=' \
--header 'api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '[
{
"ip": "<slot_IP>",
"slot": <slot_number>,
"comment": "<slot_name>"
},
]'

Delete whitelisted IP (where the IP slot is not deleted but remains empty)

With this method, the slot is not removed but remains empty. There are two options:

  • By a number of IP slot:

For Windows 10:

curl --location --request POST "https://partner.api.soax.com/v1/account/package/<package-key>/detach-ip" --header "api-key: <api-key>" --header "Content-Type: application/json" --data-raw "[{\"slot\": <slot_number>}]"

For iOS/Linux:

curl --location --request POST 'https://partner.api.soax.com/v1/account/package/<package-key>/detach-ip' \
--header 'api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '[
{
"slot": <slot_number>
}
]'
  • By the IP:

For Windows 10:

curl --location --request POST "https://partner.api.soax.com/v1/account/package/<package-key>/detach-ip" --header "api-key: <api-key>" --header "Content-Type: application/json" --data-raw "[{\"ip\": \"<slot_IP>\"}]"

For iOS/Linux:

curl --location --request POST 'https://partner.api.soax.com/v1/account/package/package-key/detach-ip' \
--header 'api-key: api-key' \
--header 'Content-Type: application/json' \
--data-raw '[
{
"ip": "IP address"
}
]'

If you have any questions or issues while using the API, please get in touch with our Support Team via live chat or by sending an email to [email protected] 👩‍💻👨‍💻

Did this answer your question?