# What customers can do These features use the same ARNPROXY account and existing website workflows. Required permissions, eligible products and verification rules are documented on each operation page. ## Account and balance Read account details, currency, balance and effective permissions. A key is provisioned on the first eligible account-page visit; administrator restrictions and verification rules remain in force. - [Permissions and available operations](https://docs.arnproxy.com/api-v1/account/capabilities) - [Account and currency](https://docs.arnproxy.com/api-v1/account/details) - [Account balance](https://docs.arnproxy.com/api-v1/account/balance) ## Purchases and multi-country orders Use up to 20 distinct location_id values under one product_id. Each country creates a separate order record; the linked checkout is handled as one invoice. Quantity discounts are calculated independently per country. - [Supported products](https://docs.arnproxy.com/api-v1/products) - [Locations, periods and purposes](https://docs.arnproxy.com/api-v1/catalog) - [Order quote; no debit](https://docs.arnproxy.com/api-v1/quote) - [Balance purchase; real debit](https://docs.arnproxy.com/api-v1/orders/create) - [Saved purchase result](https://docs.arnproxy.com/api-v1/orders/create/status) ## Accepted does not mean delivered HTTP 201/202 or state=accepted may confirm acceptance only. Follow the same operation with purchase_status / residential_purchase_status and fulfillment with order_delivery. Honor poll_after_seconds and Retry-After when present. Do not repurchase under a new Idempotency-Key after a timeout. - [Order list](https://docs.arnproxy.com/api-v1/orders/list) - [Order summary](https://docs.arnproxy.com/api-v1/orders/details) - [Current delivery and queue status](https://docs.arnproxy.com/api-v1/orders/delivery) - [Active proxies belonging to one order](https://docs.arnproxy.com/api-v1/orders/proxies) ## Active proxies, notes and export Read only your own active proxies and order connections. Manage notes and export connection details or CSV/custom content with the required permission. Other customers’ data is not exposed. - [Read the existing customer-panel note of an owned active proxy](https://docs.arnproxy.com/api-v1/proxies/note) - [Set an owned proxy note; clear using an empty string](https://docs.arnproxy.com/api-v1/proxies/note/update) - [Active proxies](https://docs.arnproxy.com/api-v1/proxies/list) - [One active proxy](https://docs.arnproxy.com/api-v1/proxies/details) - [Export connection list](https://docs.arnproxy.com/api-v1/proxies/export) - [Available actions for one proxy](https://docs.arnproxy.com/api-v1/proxies/actions) ## Renewals and automatic renewal Check renewable proxies and quotes, then renew from the balance. The automatic-renewal API manages the existing balance method; enabling it does not charge immediately or alter card-renewal settings. - [Existing automatic renewal settings of the account](https://docs.arnproxy.com/api-v1/auto-renewal) - [Balance renewal settings and eligible periods of selected proxies](https://docs.arnproxy.com/api-v1/auto-renewal/options) - [Current price estimate for automatic balance renewal](https://docs.arnproxy.com/api-v1/auto-renewal/quote) - [Enable existing automatic balance renewal; no immediate charge](https://docs.arnproxy.com/api-v1/auto-renewal/enable) - [Disable only an owned balance renewal setting](https://docs.arnproxy.com/api-v1/auto-renewal/disable) - [Read the saved result of a settings operation; never reapply](https://docs.arnproxy.com/api-v1/auto-renewal/status) - [Renewable proxies and periods](https://docs.arnproxy.com/api-v1/renewals/options) - [Renewal quote; no debit](https://docs.arnproxy.com/api-v1/renewals/quote) - [Balance renewal; real debit](https://docs.arnproxy.com/api-v1/renewals/create) - [Saved renewal result](https://docs.arnproxy.com/api-v1/renewals/status) ## IP replacement requests Get a quote, submit a request and track it. Requests follow existing administrator review; they do not instantly assign a new IP for every call. - [Replacement request quote](https://docs.arnproxy.com/api-v1/replacements/quote) - [Submit replacement for admin review](https://docs.arnproxy.com/api-v1/replacements/create) - [Saved replacement submission](https://docs.arnproxy.com/api-v1/replacements/status) - [Current replacement request states](https://docs.arnproxy.com/api-v1/replacements) ## Extra logins separate from the primary Create, list, replace and delete extra logins while preserving primary delivery credentials. Get random/custom modes and length rules from options. Some actions affect a package/order group. The account Logins page provides viewing and deletion; creation/replacement uses the API. - [Extra login replacement scope and rules](https://docs.arnproxy.com/api-v1/proxies/extra-logins/replace/options) - [Create and verify a new extra login, then revoke the old extra login](https://docs.arnproxy.com/api-v1/proxies/extra-logins/replace) - [Reconcile the same replacement; no provider writes](https://docs.arnproxy.com/api-v1/proxies/extra-logins/replace/status) - [Explicitly resume only an unsent replacement step](https://docs.arnproxy.com/api-v1/proxies/extra-logins/replace/resume) - [Extra login scope and options](https://docs.arnproxy.com/api-v1/proxies/extra-logins/options) - [Create extra credentials without changing the primary](https://docs.arnproxy.com/api-v1/proxies/extra-logins/create) - [Extra login and its owned proxies](https://docs.arnproxy.com/api-v1/proxies/extra-logins/details) - [Revoke only the selected extra login](https://docs.arnproxy.com/api-v1/proxies/extra-logins/delete) - [Reconcile the same extra-login operation](https://docs.arnproxy.com/api-v1/proxies/extra-logins/status) - [Explicitly approve an unsent step](https://docs.arnproxy.com/api-v1/proxies/extra-logins/resume) - [Customer API supplemental registry](https://docs.arnproxy.com/api-v1/proxies/extra-logins) - [Supplemental login assessment and cleanup planning history](https://docs.arnproxy.com/api-v1/proxies/extra-logins/history) ## Proxy authorized-IP management Use IP add/remove only as allowed by the scope/options response. Actions may be package-wide; do not omit scope acknowledgments. API removal is limited to your account’s recorded API-added IP grants. - [Verify credential group and available actions](https://docs.arnproxy.com/api-v1/proxies/access) - [Add an authorized IP within verified scope](https://docs.arnproxy.com/api-v1/proxies/authorized-ips/add) - [Remove only an authorized IP created through this API](https://docs.arnproxy.com/api-v1/proxies/authorized-ips/remove) - [Reconcile the same operation without resending writes](https://docs.arnproxy.com/api-v1/proxies/access/status) - [Primary-credential operations cannot resume; admin review required](https://docs.arnproxy.com/api-v1/proxies/access/resume) - [Disabled: primary credentials are admin-managed (403)](https://docs.arnproxy.com/api-v1/proxies/primary-credentials/change) · HTTP 403 ## Residential: new package versus GB top-up Customers do not select a purpose for Residential orders. For a new package, the server automatically assigns the same fixed purpose as the website checkout; do not send purpose_id, subpurpose_id or other_purpose. A top-up preserves the existing package purpose. - [Residential GB packages, website prices and purposes](https://docs.arnproxy.com/api-v1/residential/catalog) - [New package / top-up price; no debit](https://docs.arnproxy.com/api-v1/residential/quote) - [Balance Residential order via website delivery queue](https://docs.arnproxy.com/api-v1/residential/orders/create) - [Saved acceptance and current Residential delivery state](https://docs.arnproxy.com/api-v1/residential/orders/status) ## Locations, IP pool and connection lists Read country/region/city/ISP choices and IP-pool observations. Create lists, change their title/rotation or delete them. Select supported login/password or IP authentication when creating a list. Pool counts may be cached observations, not an IP guarantee for every connection. - [Country, region, city and ISP options](https://docs.arnproxy.com/api-v1/residential/locations) - [Hourly traffic history of owned registered logins only](https://docs.arnproxy.com/api-v1/residential/traffic) - [Export an existing connection list; does not create a list](https://docs.arnproxy.com/api-v1/residential/export) - [Owned packages; stored snapshot](https://docs.arnproxy.com/api-v1/residential/packages) - [One package; stored snapshot](https://docs.arnproxy.com/api-v1/residential/packages/details) - [Connection lists for a package](https://docs.arnproxy.com/api-v1/residential/lists) - [One connection list](https://docs.arnproxy.com/api-v1/residential/lists/details) - [List create/delete scope and revision](https://docs.arnproxy.com/api-v1/residential/lists/options) - [Create a connection list in an existing package; no GB purchase](https://docs.arnproxy.com/api-v1/residential/lists/create) - [Delete only an owned connection list; never the package](https://docs.arnproxy.com/api-v1/residential/lists/delete) - [Verify the list operation with GETs; never resend create/delete](https://docs.arnproxy.com/api-v1/residential/lists/action-status) - [Check list settings with provider](https://docs.arnproxy.com/api-v1/residential/lists/check) - [Refresh package snapshot; no GB purchase](https://docs.arnproxy.com/api-v1/residential/packages/refresh) - [Rename a connection list](https://docs.arnproxy.com/api-v1/residential/lists/rename) - [Change connection list rotation](https://docs.arnproxy.com/api-v1/residential/lists/rotation) - [Check the same operation; does not repeat the write](https://docs.arnproxy.com/api-v1/residential/lists/status) ## Sessions & targeting Create and verify an eligible special Residential list first, then prepare session/TTL connection strings. Formatting a connection does not consume traffic; actual use does. - [Session-list scope and existing special lists](https://docs.arnproxy.com/api-v1/residential/sessions/options) - [Create a separate session list; no GB purchase](https://docs.arnproxy.com/api-v1/residential/sessions/create) - [Format targeted connections from a special session list](https://docs.arnproxy.com/api-v1/residential/sessions/export) - [Residential ISP identifiers](https://docs.arnproxy.com/api-v1/residential/isp-codes) ## Rotating proxies Set the IP-change interval in seconds for an eligible Rotating package. This is not an instant IP-swap action; the setting applies at package scope. - [Rotating package scope and current rotation interval](https://docs.arnproxy.com/api-v1/rotating/options) - [Change a Rotating package rotation interval](https://docs.arnproxy.com/api-v1/rotating/rotation) - [Verify a Rotating operation using reads only; never resend](https://docs.arnproxy.com/api-v1/rotating/status) ## Two separate IP allowlists The allowlist in My account → API controls which addresses may use the API key and is managed on the account page. Proxy authorized-IP operations control which addresses may connect to the proxy. These settings do not modify one another. ## Webhooks and ready-made clients Webhooks are optional. Use your own HTTPS receiver and verify signatures, or follow results with status requests. PHP, Python, Node.js, Java and Go SDKs and Postman collections are available. ## Unavailable operations and important limits There is no card/bank balance-deposit API; fund the account on the website. Primary delivery credentials cannot be changed or deleted through the customer API. IP replacement follows the existing administrator-review process. Deleting a Residential connection list does not delete the GB package. Permissions come from administrator account settings; customers do not select additional scopes. Existing administrator restrictions apply.