Auto-renewal
Updated:
Works for every proxy type, including the residential package.
Permissions: account:read, account:write, billing:write
calc_autoprolong_cost
🟢 read-only · account:read
The next automatic charge and its date, without changing anything.
Takes the same parameters as enable_autoprolong.
Returns: {total, discount, quantity, orders, balance, items[], days | tarifId, chargeDate, dateEnd, paymentId, autoProlong, warning, currency: "USD"}. items are the proxies that would be renewed (same shape as list_proxies, password masked), chargeDate is when the funds must be on the balance (null for residential), autoProlong says whether it is already on for every selected proxy. When the period was inferred, periodId and a _note say which one. Verified against the stage API 2026-10-06.
enable_autoprolong
💳 spends money · billing:write
Turn auto-renewal on. Nothing is charged now, but future renewals are charged automatically.
Parameter | Type | Description |
|---|---|---|
| proxy type | Product type |
| string |
|
| arrays | Which proxies, by type as in make_prolong ( |
| string | Renewal period to price. Optional: with auto-renewal already on, the bound period is priced; otherwise the server prices the period the proxies currently run on (from their rental term) and the result names it in |
| string | With |
| string | Residential only — must match the current tariff |
| string | Promo code |
calc_autoprolong_cost takes the same parameters.
Returns: {autoProlong: true, quantity, ids[], orderIds[], days, paymentId, chargeDate, dateEnd, warning} — what was actually switched on (for ipv6 / mix / mix_isp a whole order at once); there is no total, use calc_autoprolong_cost for the amount. Verified against the stage API 2026-10-06. With paddle_subscription and no subscriptionId: {status: "not_enabled", paddleSubscription: {cardConnected, subscriptionId?, card?, nextSteps}} and nothing changes.
Typical failure: a non-empty warning means auto-renewal is on but the balance will not cover the next charge — top up before chargeDate. With paddle_subscription and no card connected the result is status: "not_enabled", nothing changes.
disable_autoprolong
🟡 changes account state · account:write
Turn auto-renewal off. Proxies stay active until their current expiry date.
Parameter | Type | Description |
|---|---|---|
| proxy type | Product type |
| arrays | Which proxies, by type as in make_prolong ( |