Skip to content
REST API JSON in, JSON out

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.

api.sh bash
# 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/
header auth, paginated JSON REST
Auth API-KEY JSON paginated
20 per page default
1 auth header
JSON responses
Rotation control
7 days cash back
Same data as the dashboard No SDK required — any HTTP client Credentials and allowlists included

Works with your stack

Python Node.js JavaScript TypeScript Go PHP Ruby Rust C++ Kotlin Swift Selenium Scrapy cURL Pytest Docker Kubernetes GitHub PostgreSQL Redis

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

GET user/data/ Account settings: proxy password, TCP fingerprints, minimum order, rotating connect, Trojan domains.
GET user/payment_gateways/ Payment methods available to the account.

IPs

GET available/ips/ Available products. Filters: service (proxy, shared_proxy, socks, shared_socks, dns_proxy, vpn_wireguard), version, tag_id, location.
GET user/ips/ Your purchased IPs. Same filter set.
PUT / DELETE user/ips/modify/ Modify owned IPs. Body: service, service_ids.
GET user/ips/counters/ Counters of IPs by status.

Rotating proxies

GET user/rotating_proxies/configurations/ Rotation configs. Filter: service (residential_proxy, datacenter_proxy, mobile_proxy).
POST / DELETE user/rotating_proxies/configurations/modify/ Create or delete. Body: name (max 64), service, country/location, sticky.
GET rotating_proxies/locations/ Locations for a service. Note: no user/ in this path.
GET user/rotating_proxies/stats/ Usage by service. Filters: service, date range.

Credentials and allowlist

GET / PUT user/proxy-credentials/ Read or update the proxy password. PUT body: proxy_password.
GET user/proxy-credentials/ips/ Your authentication IPs.
POST / DELETE user/proxy-credentials/ips/modify/ Add or remove allowlist IPs. Body: ips (array).

Cart, orders and balance

GET user/cart/ Cart counters. DELETE empties the cart.
POST user/cart/calculate/ Calculate cart price. Variants: order/calculate, rotating/calculate, balance/calculate.
GET user/orders/ Order history. Filter: service, status, date.
POST user/order/ Create an order. Variants: rebill, rotating, upgrade_downgrade.
GET 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.

quickstart.py python
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={...})
same flow as the dashboard REST

Pagination

List endpoints return 20 per page by default.
Use start and limit to page through results.
The response carries total and next links.

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.

Step 1

Pick one product for one target — a static IP or a small rotating allowance.

Step 2

Call the API, run your real workflow, watch the usage panel.

Step 3

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.