ISP Proxies (Static Residential)
This page describes how to manage ISP proxy packages for your subusers. ISP proxies are static residential proxies that provide stable IP addresses from Internet Service Providers. These are perfect for applications requiring long-term IP consistency.
ISP proxies are static residential proxies that remain unchanged for extended periods. They come in two types: Virgin (never used before as proxies) and Non-virgin. You can choose between shared (up to 3 users) or dedicated (single user) configurations. The sharedType affects pricing, with dedicated being more expensive but offering exclusive access.
Get Stock
This endpoint allows you to check available ISP proxy stock by location, ISP, and configuration. Use this to see what's available before placing orders.
Required Parameters
- Name
username
- Type
- string
- Description
The username of the subuser to check stock for.
Returned Properties
- Name
data
- Type
- object
- Description
Stock information organized by residential type, virgin status, shared type, country, ISP, and city.
- Name
status
- Type
- number
- Description
The status code of the response.
- Name
message
- Type
- string
- Description
The message of the response.
- Name
timestamp
- Type
- number
- Description
The timestamp in milliseconds of the response.
Request
curl "https://reseller.evomi.com/v2/reseller/sub_users/isp/stock?username=Evomi_customer" \
-H 'X-API-KEY: [API KEY]'
Response
{
"status": 200,
"message": "",
"timestamp": 1750066722733,
"data": {
"residential": {
"nonvirgin": {
"shared": {
"US": {
"astound": {
"losangeles": {
"stock": 469,
"price": 1
}
}
}
},
"dedicated": {
"US": {
"astound": {
"losangeles": {
"stock": 4,
"price": 2.5
}
}
}
}
},
"virgin": {
"dedicated": {
"US": {
"astound": {
"losangeles": {
"stock": 315,
"price": 4.5
}
}
}
}
}
}
}
}
Get Active Packages
This endpoint retrieves all active ISP proxy packages for a specific subuser, including package details and individual IP information.
Required Parameters
- Name
username
- Type
- string
- Description
The username of the subuser to get active packages for.
Returned Properties
- Name
data
- Type
- array
- Description
Array of active packages with detailed information.
- Name
status
- Type
- number
- Description
The status code of the response.
- Name
message
- Type
- string
- Description
The message of the response.
- Name
timestamp
- Type
- number
- Description
The timestamp in milliseconds of the response.
Request
curl "https://reseller.evomi.com/v2/reseller/sub_users/isp/active_packages?username=Evomi_customer" \
-H 'X-API-KEY: [API KEY]'
Response
{
"timestamp": 1750067039034,
"data": [
{
"id": 360,
"packageName": "3 x residential virgin dedicated US astound losangeles static proxies with 5000 threads",
"username": "Evomi_customer",
"expiryDate": "2025-08-15T09:41:49.979103Z",
"periodPrice": 16.2,
"ips": [
{
"password": "proxy_password_1",
"ipInfo": {
"IP": "192.168.1.1",
"SourceType": "residential",
"Country": "US",
"ISP": "astound",
"City": "losangeles",
"SharedType": "dedicated"
}
},
{
"password": "proxy_password_2",
"ipInfo": {
"IP": "192.168.1.2",
"SourceType": "residential",
"Country": "US",
"ISP": "astound",
"City": "losangeles",
"SharedType": "dedicated",
}
}
]
}
],
"status": 200,
"message": ""
}
Order Package
This endpoint allows you to order a new ISP proxy package for a subuser. The configuration options determine pricing and capabilities.
Required Body Parameters
- Name
username
- Type
- string
- Description
The username of the subuser to create the package for.
- Name
months
- Type
- number
- Description
Number of months for the package subscription.
- Name
country
- Type
- string
- Description
Country code (e.g., "US"). Must be available in stock.
- Name
city
- Type
- string
- Description
City name (e.g., "losangeles"). Must be available in stock.
- Name
isp
- Type
- string
- Description
ISP provider (e.g., "astound"). Must be available in stock.
- Name
numberOfIPs
- Type
- number
- Description
Number of IPs to include in the package (minimum 3).
- Name
sharedType
- Type
- string
- Description
Either "dedicated" (single user) or "shared" (up to 3 users).
- Name
isVirgin
- Type
- boolean
- Description
Whether to use virgin IPs (never sold before as proxies). Only available when sharedType is "dedicated".
- Name
highConcurrency
- Type
- boolean
- Description
Whether to enable high concurrency (5000 threads vs 400 default). Increases price but allows more concurrent connections.
Returned Properties
- Name
data
- Type
- object
- Description
Contains success status and packageId if successful.
- Name
status
- Type
- number
- Description
The status code of the response.
- Name
message
- Type
- string
- Description
The message of the response.
- Name
timestamp
- Type
- number
- Description
The timestamp in milliseconds of the response.
Request
curl -X "POST" "https://reseller.evomi.com/v2/reseller/sub_users/isp/create_order?username=Evomi_customer" \
-H 'X-API-KEY: [API KEY]' \
-H 'Content-Type: application/json; charset=utf-8' \
-d '{
"months": 1,
"city": "losangeles",
"country": "US",
"highConcurrency": true,
"username": "Evomi_customer",
"isVirgin": true,
"sharedType": "dedicated",
"numberOfIPs": 3,
"isp": "astound"
}'
Response
{
"status": 200,
"message": "",
"timestamp": 1750066910956,
"data": {
"success": true,
"packageId": 360
}
}
Renew Package
This endpoint allows you to renew an existing ISP proxy package. This extends the package with the same configuration and IPs.
Required Body Parameters
- Name
username
- Type
- string
- Description
The username of the subuser who owns the package.
- Name
packageId
- Type
- number
- Description
The ID of the package to renew (obtained from active packages or order response).
Returned Properties
- Name
data
- Type
- object
- Description
Contains success status indicating if the renewal was successful.
- Name
status
- Type
- number
- Description
The status code of the response.
- Name
message
- Type
- string
- Description
The message of the response.
- Name
timestamp
- Type
- number
- Description
The timestamp in milliseconds of the response.
Request
curl -X "POST" "https://reseller.evomi.com/v2/reseller/sub_users/isp/renew_package?username=Evomi_customer" \
-H 'X-API-KEY: [API KEY]' \
-H 'Content-Type: application/json; charset=utf-8' \
-d '{
"username": "Evomi_customer",
"packageId": 360
}'
Response
{
"timestamp": 1750067025772,
"data": {
"success": true
},
"status": 200,
"message": ""
}