🎁 Free 12-hour test for every new account · 🇩🇪 Real German 4G carrier IPs · ♾️ Unlimited bandwidth · unlimited rotations · ₿ Pay with crypto or card

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.

http
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.

FieldTypeDescription
idstringUnique identifier, e.g. px_a1b2c3d4.
planstringOne of 1d, 7d, 30d (or trial).
statusstringactive while usable, expired once the term ends, released if ended early.
hoststringProxy hostname, e.g. de1.proxion.io.
portintegerProxy port for both HTTP and SOCKS5.
usernamestringCredential for username:password auth.
passwordstringCredential for username:password auth.
protocolsstring[]Supported protocols: ["http", "socks5"].
countrystringISO country code — always DE.
os_profilestringTCP fingerprint profile: none, windows, macos, android, ios or linux.
allowed_ipsstring[]IPs / CIDR ranges allowed without username:password (max. 20).
created_atstringWhen the proxy was provisioned.
expires_atstringWhen 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.

GET/v1/plans

List plans

Returns the available durations and their price in cents. No auth required.

Request
curl https://api.proxion.io/v1/plans
Response
{
  "data": [
    { "plan": "1d",  "price_cents": 600  },
    { "plan": "7d",  "price_cents": 2900 },
    { "plan": "30d", "price_cents": 7900 }
  ]
}
POST/v1/proxies

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" }.

Request
curl -X POST https://api.proxion.io/v1/proxies \
  -H "Authorization: Bearer prx_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "plan": "7d" }'
Response
{
  "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"
}
GET/v1/proxies

List your proxies

Returns your proxies, newest first. Filter with ?status=active|expired and paginate with limit / starting_after.

Request
curl "https://api.proxion.io/v1/proxies?status=active&limit=20" \
  -H "Authorization: Bearer prx_live_xxx"
Response
{
  "data": [ { "id": "px_a1b2c3d4", "status": "active", "...": "..." } ],
  "has_more": false
}
GET/v1/proxies/{id}

Retrieve a proxy

Fetches a single proxy by id, including its current credentials and expiry.

Request
curl https://api.proxion.io/v1/proxies/px_a1b2c3d4 \
  -H "Authorization: Bearer prx_live_xxx"
Response
{
  "id": "px_a1b2c3d4",
  "status": "active",
  "host": "de1.proxion.io",
  "port": 24915,
  "expires_at": "2026-07-29T10:00:00Z"
}
POST/v1/proxies/{id}/rotate

Rotate the IP

Assigns a fresh mobile IP to the proxy while keeping the same credentials. Or simply keep connecting to hold the current IP.

Request
curl -X POST https://api.proxion.io/v1/proxies/px_a1b2c3d4/rotate \
  -H "Authorization: Bearer prx_live_xxx"
Response
{
  "id": "px_a1b2c3d4",
  "host": "de3.proxion.io",
  "port": 28104,
  "username": "px_9f3a2",
  "password": "b7c1d9e0f2a4"
}
POST/v1/proxies/{id}/extend

Extend a proxy

Adds another term to an active proxy so it keeps the same IP and credentials past its original expiry. Body: { "plan": "7d" }.

Request
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" }'
Response
{
  "id": "px_a1b2c3d4",
  "status": "active",
  "expires_at": "2026-08-05T10:00:00Z"
}
PATCH/v1/proxies/{id}

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.

Request
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"] }'
Response
{
  "id": "px_a1b2c3d4",
  "status": "active",
  "os_profile": "windows",
  "allowed_ips": ["203.0.113.7", "10.0.0.0/24"]
}
DELETE/v1/proxies/{id}

Release a proxy

Ends a proxy early and frees its IP. Irreversible; no refund for remaining time.

Request
curl -X DELETE https://api.proxion.io/v1/proxies/px_a1b2c3d4 \
  -H "Authorization: Bearer prx_live_xxx"
Response
{
  "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.

bash
# 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.

bash
# 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
Chat with us