This guide shows you how to renew (extend) proxies you already own through the API, so you keep the same IP addresses. Renew on time — once a proxy expires the IP may be lost.

Every request uses your personal API key from your account dashboard (how to get your API key). In the examples below, replace YOUR_API_KEY with your own key. To pay from your account balance, use paymentId = 1.

⚠️ The final step charges your balance. Always check the cost with the calculation step first.

The flow at a glance

Find the proxies to renew and copy their IDs.
Pick a payment method (or use your balance).
Calculate the renewal cost.
Make the renewal.

Step 1 — Find the proxies to renew

List your active proxies and copy the id of each one you want to extend. Only proxies with can_prolong: true can be renewed. Note the proxy type (ipv4, ipv6, mobile, isp, mix, mix_isp) — you'll need it in the next steps.

Endpoint

GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/list/{type}

Path parameters

Name	Value	Description
type (optional)	`ipv4`	The proxy type to retrieve. If omitted, all types are returned.

Optional query parameters

Name	Type	Description
latest	String	Y/N — return proxies from the last order only.
orderId	String	Return proxies from a specific orderId or baseOrderNumber.
country	String	Alpha-3 country code (e.g. FRA, USA).
ends	String	Y — only proxies that are about to expire.

Example

https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/list/ipv4

Response

{
  "status": "success",
  "data": {
    "items": [
      {
        "id": "0678564",
        "order_id": "123456",
        "ip": "31.6.33.97",
        "protocol": "HTTP",
        "port_http": 12345,
        "port_socks": 12345,
        "login": "ruht5734hg",
        "password": "gou5h437g",
        "country": "Belgium",
        "country_alpha3": "BEL",
        "status_type": "ACTIVE",
        "can_prolong": true,
        "date_start": "23.06.2024",
        "date_end": "23.07.2024",
        "auto_renew": "N"
      }
    ]
  },
  "errors": []
}

Copy the id of each proxy to renew. Make sure can_prolong is true.

Step 2 — Choose a payment method

List the available payment systems and copy the id you want as paymentId. To pay from your account balance, you can skip this step and simply use paymentId = 1.

Endpoint

GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/balance/payments/list

Response

{
  "status": "success",
  "data": {
    "items": [
      { "id": "30", "name": "Visa / MasterCard" },
      { "id": "41", "name": "USDT (TRC-20)" },
      { "id": "29", "name": "PayPal" },
      { "id": "35", "name": "Binance" }
    ]
  },
  "errors": []
}

Step 3 — Calculate the renewal cost

Before paying, calculate the cost. Volume and rental-period discounts are applied just like on the website. This step does not charge anything.

Endpoint

POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/prolong/calc/{type}

Request body

Name	Type	Description
ids	Number / Array	A single ID or an array of IDs in `[ ]`, separated by commas — from Step 1.
periodId	String	ID of the renewal period. Get the available periods from the `/reference/list/{type}` endpoint.
paymentId	String	Payment system ID. `1` = balance, `43` = card added to your account.
coupon (optional)	String	A coupon code, if you have one.

Example

https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/prolong/calc/ipv4

Response — shows the total, your balance, the discount and the proxies being renewed:

{
  "status": "success",
  "data": {
    "warning": "",
    "balance": 40.4,
    "total": 35.1,
    "quantity": 5,
    "currency": "USD",
    "discount": 0.22,
    "items": [ ... proxies being renewed ... ],
    "orders": 2
  },
  "errors": []
}

If your balance is too low, you'll get an Insufficient funds warning:

{
  "status": "error",
  "data": {
    "warning": "Insufficient funds. Total $2. Not enough $33.10",
    "balance": 2,
    "total": 35.1
  },
  "errors": []
}

Step 4 — Make the renewal (charges your balance)

When the calculated cost looks right, create the renewal order. This step charges your balance. Use the same parameters as in Step 3.

Endpoint

POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/prolong/make/{type}

Request body

Name	Type	Description
ids	Number / Array	A single ID or an array of IDs in `[ ]`, separated by commas.
periodId	String	ID of the renewal period (from `/reference/list/{type}`).
paymentId	String	Payment system ID. `1` = balance.
coupon (optional)	String	A coupon code, if you have one.

Example

https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/prolong/make/ipv4

Response — returns the new order ID and your updated balance:

{
  "status": "success",
  "data": {
    "orderId": 3388536,
    "total": 35.1,
    "listBaseOrderNumbers": [ "1000000_57471911" ],
    "balance": 40.4
  },
  "errors": []
}

The proxies keep the same IPs with a new expiry date.