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.


GET/v2/reseller/sub_users/isp/stock

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

GET
/v2/reseller/sub_users/isp/stock
  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/v2/reseller/sub_users/isp/active_packages

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

GET
/v2/reseller/sub_users/isp/active_packages
  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": ""
}

POST/v2/reseller/sub_users/isp/create_order

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

POST
/v2/reseller/sub_users/isp/create_order
  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
}
}

POST/v2/reseller/sub_users/isp/renew_package

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

POST
/v2/reseller/sub_users/isp/renew_package
  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": ""
}