API Documentation: The Account, Programmable
Everything the dashboard can do, the API can do. List and filter IPs, manage credentials and allowlists, control rotation, read usage, calculate a cart and place an order — all over HTTPS with a single header.
# base
https://ipn.proxyperk.com/api/myaccount/
# list your IPs
$ curl -H "API-KEY: $KEY" \
.../user/ips/?service=proxy&start=0&limit=20
# usage, last 24 h
$ curl -H "API-KEY: $KEY" \
.../user/rotating_proxies/stats/
Works with your stack
Reference
The Endpoints You Will Actually Call
Every path below hangs off https://ipn.proxyperk.com/api/myaccount/. They are grouped by what they do, not by HTTP verb.
Account
user/data/
Account settings: proxy password, TCP fingerprints, minimum order, rotating connect, Trojan domains.
user/payment_gateways/
Payment methods available to the account.
IPs
available/ips/
Available products. Filters: service (proxy, shared_proxy, socks, shared_socks, dns_proxy, vpn_wireguard), version, tag_id, location.
user/ips/
Your purchased IPs. Same filter set.
user/ips/modify/
Modify owned IPs. Body: service, service_ids.
user/ips/counters/
Counters of IPs by status.
Rotating proxies
user/rotating_proxies/configurations/
Rotation configs. Filter: service (residential_proxy, datacenter_proxy, mobile_proxy).
user/rotating_proxies/configurations/modify/
Create or delete. Body: name (max 64), service, country/location, sticky.
rotating_proxies/locations/
Locations for a service. Note: no user/ in this path.
user/rotating_proxies/stats/
Usage by service. Filters: service, date range.
Credentials and allowlist
user/proxy-credentials/
Read or update the proxy password. PUT body: proxy_password.
user/proxy-credentials/ips/
Your authentication IPs.
user/proxy-credentials/ips/modify/
Add or remove allowlist IPs. Body: ips (array).
Cart, orders and balance
user/cart/
Cart counters. DELETE empties the cart.
user/cart/calculate/
Calculate cart price. Variants: order/calculate, rotating/calculate, balance/calculate.
user/orders/
Order history. Filter: service, status, date.
user/order/
Create an order. Variants: rebill, rotating, upgrade_downgrade.
user/balance/
Balance amount. POST creates a top-up payment.
Quickstart
Three Calls to First IP
Authenticate, list what is available, add to cart, place the order. The rest is the same pattern with different paths.
1. Authenticate
Send API-KEY: your-key in the header. The key is in the portal.
2. List available
Call available/ips/ with a service filter. Each row carries country, state and city.
3. Cart and order
Add IPs to the cart, calculate, then create the order. Balance is checked server-side.
Any HTTP client
curl, requests, fetch, axios — no SDK, no build step, no special transport.
BASE = "https://ipn.proxyperk.com/api/myaccount/"
H = {"API-KEY": key}
# 1. what is available?
ips = get(BASE + "available/ips/?service=proxy")
# 2. add to cart
post(BASE + "user/cart/ips/modify/",
json={...})
# 3. place the order
post(BASE + "user/order/", json={...})
Pagination
Guarantee
Test It Before You Trust It
An endpoint reference is not proof. Buy the smallest thing that tests the connection in your own pipeline, then measure it.
Pick one product for one target — a static IP or a small rotating allowance.
Call the API, run your real workflow, watch the usage panel.
Not delivered or not as described? Open a dashboard ticket within 7 days.
Every ProxyPerk product carries a 7-day instant cash back guarantee — datacenter included, and datacenter IPs are additionally trial-eligible for one hour. Once support confirms the request, the refund is processed straight away, with no retention call.
Covers non-delivery and service issues. Third-party software incompatibility, prohibited uses and used service are excluded — Refund Policy.
Help center
API questions
The questions that come up before the first request.
Need the same data from the dashboard? See the client portal guide.