Proxy-seller

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

type required

proxy type

Product type

paymentId required

string

balance or paddle_subscription

ips / ids / orderIds

arrays

Which proxies, by type as in make_prolong (orderIds for ipv6 / mix / mix_isp); send none for resident

periodId

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 periodId and _note. Pass it explicitly to price another period

subscriptionId

string

With paddle_subscription; taken from get_autotopup

tarifId

string

Residential only — must match the current tariff

coupon

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

type required

proxy type

Product type

ips / ids / orderIds

arrays

Which proxies, by type as in make_prolong (orderIds for ipv6 / mix / mix_isp); send none for resident

Next steps

On this page