API Reference
Buy, rotate, and manage German 4G proxies programmatically. A small, predictable REST API — JSON in, JSON out.
Base URLhttps://api.proxion.io/v1
All endpoints are versioned under /v1 and served over HTTPS only.
Authentication
Authenticate every request with an API key in the Authorization header. Create and revoke keys in your dashboard under API keys. Keys are secret — never expose them in client-side code.
Authorization: Bearer prx_live_xxx
Test keys (prx_test_…) create proxies that behave identically but are never billed.
Conventions
The whole API follows a few consistent rules, so once you have called one endpoint you know them all.
JSON everywhere
Request and response bodies are UTF-8 JSON. Timestamps are ISO-8601 in UTC (e.g. 2026-07-22T10:00:00Z).
Predictable errors
Failures use standard HTTP status codes and return { "error": { "code", "message" } }. The code is stable and safe to switch on; the message is human-readable.
Cursor pagination
List endpoints accept limit (1–100) and starting_after=<id>, and return { "data": [...], "has_more": bool }.
Rate limits
Every authenticated response carries X-RateLimit-Limit and X-RateLimit-Remaining — 120 requests per minute per key. Exceeding the limit returns 429 with Retry-After; retry once the window resets.
The proxy object
Buying a proxy returns a proxy object. It is the single resource you work with — its credentials never change unless you rotate it.
| Field | Type | Description |
|---|
id | string | Unique identifier, e.g. px_a1b2c3d4. |
plan | string | One of 1d, 7d, 30d (or trial). |
status | string | active while usable, expired once the term ends, released if ended early. |
host | string | Proxy hostname, e.g. de1.proxion.io. |
port | integer | Proxy port for both HTTP and SOCKS5. |
username | string | Credential for username:password auth. |
password | string | Credential for username:password auth. |
protocols | string[] | Supported protocols: ["http", "socks5"]. |
country | string | ISO country code — always DE. |
os_profile | string | TCP fingerprint profile: none, windows, macos, android, ios or linux. |
allowed_ips | string[] | IPs / CIDR ranges allowed without username:password (max. 20). |
created_at | string | When the proxy was provisioned. |
expires_at | string | When access ends and the IP is released. |
Endpoints
Eight endpoints cover the full lifecycle: discover plans, buy a proxy, inspect it, rotate its IP, change its settings, extend it, and release it early.
List plans
Returns the available durations and their price in cents. No auth required.
curl https://api.proxion.io/v1/plans
{
"data": [
{ "plan": "1d", "price_cents": 600 },
{ "plan": "7d", "price_cents": 2900 },
{ "plan": "30d", "price_cents": 7900 }
]
}
Buy a proxy
Provisions a new German 4G proxy on the given plan and returns it with credentials, ready to use immediately. Body: { "plan": "7d" }.
curl -X POST https://api.proxion.io/v1/proxies \
-H "Authorization: Bearer prx_live_xxx" \
-H "Content-Type: application/json" \
-d '{ "plan": "7d" }'
{
"id": "px_a1b2c3d4",
"plan": "7d",
"status": "active",
"host": "de1.proxion.io",
"port": 24915,
"username": "px_9f3a2",
"password": "b7c1d9e0f2a4",
"protocols": ["http", "socks5"],
"country": "DE",
"os_profile": "none",
"allowed_ips": [],
"created_at": "2026-07-22T10:00:00Z",
"expires_at": "2026-07-29T10:00:00Z"
}
List your proxies
Returns your proxies, newest first. Filter with ?status=active|expired and paginate with limit / starting_after.
curl "https://api.proxion.io/v1/proxies?status=active&limit=20" \
-H "Authorization: Bearer prx_live_xxx"
{
"data": [ { "id": "px_a1b2c3d4", "status": "active", "...": "..." } ],
"has_more": false
}
Retrieve a proxy
Fetches a single proxy by id, including its current credentials and expiry.
curl https://api.proxion.io/v1/proxies/px_a1b2c3d4 \
-H "Authorization: Bearer prx_live_xxx"
{
"id": "px_a1b2c3d4",
"status": "active",
"host": "de1.proxion.io",
"port": 24915,
"expires_at": "2026-07-29T10:00:00Z"
}
POST/v1/proxies/{id}/rotateRotate the IP
Assigns a fresh mobile IP to the proxy while keeping the same credentials. Or simply keep connecting to hold the current IP.
curl -X POST https://api.proxion.io/v1/proxies/px_a1b2c3d4/rotate \
-H "Authorization: Bearer prx_live_xxx"
{
"id": "px_a1b2c3d4",
"host": "de3.proxion.io",
"port": 28104,
"username": "px_9f3a2",
"password": "b7c1d9e0f2a4"
}
POST/v1/proxies/{id}/extendExtend a proxy
Adds another term to an active proxy so it keeps the same IP and credentials past its original expiry. Body: { "plan": "7d" }.
curl -X POST https://api.proxion.io/v1/proxies/px_a1b2c3d4/extend \
-H "Authorization: Bearer prx_live_xxx" \
-H "Content-Type: application/json" \
-d '{ "plan": "7d" }'
{
"id": "px_a1b2c3d4",
"status": "active",
"expires_at": "2026-08-05T10:00:00Z"
}
Update settings
Sets the TCP OS fingerprint profile (none, windows, macos, android, ios, linux) and/or the IP whitelist. Omitted fields stay unchanged; allowed_ips replaces the whole list.
curl -X PATCH https://api.proxion.io/v1/proxies/px_a1b2c3d4 \
-H "Authorization: Bearer prx_live_xxx" \
-d '{ "os_profile": "windows", "allowed_ips": ["203.0.113.7", "10.0.0.0/24"] }'
{
"id": "px_a1b2c3d4",
"status": "active",
"os_profile": "windows",
"allowed_ips": ["203.0.113.7", "10.0.0.0/24"]
}
Release a proxy
Ends a proxy early and frees its IP. Irreversible; no refund for remaining time.
curl -X DELETE https://api.proxion.io/v1/proxies/px_a1b2c3d4 \
-H "Authorization: Bearer prx_live_xxx"
{
"id": "px_a1b2c3d4",
"status": "released"
}
Connecting to a proxy
Use the returned host, port, username, and password with any HTTP or SOCKS5 client. The same credentials work for both protocols.
# HTTP
curl -x http://px_9f3a2:b7c1d9e0f2a4@de1.proxion.io:24915 \
https://api.ipify.org
# → 185.XX.XX.XX (DE · 4G)
# SOCKS5
curl -x socks5://px_9f3a2:b7c1d9e0f2a4@de1.proxion.io:24915 \
https://api.ipify.org
Quick start
Buy a 7-day proxy and make your first request through it in two calls.
# 1. Buy a 7-day proxy
curl -X POST https://api.proxion.io/v1/proxies \
-H "Authorization: Bearer prx_live_xxx" \
-d '{ "plan": "7d" }'
# 2. Route a request through it
curl -x http://px_9f3a2:b7c1d9e0f2a4@de1.proxion.io:24915 \
https://api.ipify.org