Skip to main content

​
Error reference

On validation failures the message field is an array of strings, not a single string. Handle both shapes when parsing errors.

​
There is no “not enough data” error

The residential pool is tracked, not enforced. Creating or topping up a sub-user never fails for lack of data — remainingBytes just goes negative. Watch that figure yourself and buy more residential data when it crosses zero. Static proxy capacity is the opposite: it is enforced, and over-drawing returns 400 with nothing assigned.

​
Retries

502 responses are always safe to retry. Sub-user creation, data adjustments, deletion, and proxy allocation are atomic: on any failure, nothing is charged and nothing is left half-created.
  • A 502 on POST /reseller/users means no account was created and no data was debited.
  • A 502 on DELETE /reseller/users/:username means the sub-user is untouched — credentials still work, nothing was refunded.
  • A 502 on POST /reseller/proxies means no IPs were assigned and no capacity was taken.
Other statuses are not transient — retrying a 400, 404, or 409 with the same body returns the same error.

​
Suspended accounts

If every call starts returning 401 Reseller account is suspended, contact support. Your existing sub-users keep working upstream until their data runs out, so your customers aren’t cut off immediately, but you can’t create, adjust, or allocate anything while suspended.

​
Sub-user lifecycle

Sub-users can be deleted, and unconsumed data comes back to your pool — both on deletion and on a negative data adjustment. Data your customer already consumed is gone for good.
Deletion is irreversible and drains the upstream account first. To restore access for a customer, create a new sub-user with a fresh username.

​
Usage etiquette

Live usage lookups hit the gateway. Fetch them when you actually need them — page loads, billing runs — rather than in tight polling loops: Without those flags, usage history is served from stored data and makes no gateway calls at all — use it for dashboards and trends. Questions? Contact your Roundproxies account manager or email team@roundproxies.com.