REST API overview

The REST API exposes everything you need to run proxies from code: list and configure proxies, rotate mobile IPs, read usage, generate residential endpoints and read your orders. Purchases and top-ups stay in the dashboard: there is no endpoint to create a purchase or a crypto invoice.

The public API uses version v1. Changes are additive only: new endpoints, new optional parameters and new response fields can appear; existing fields are never removed, renamed or retyped within v1. Write clients that ignore unknown fields.

Base URL#

https://proxuno.com/api/v1

Use HTTPS in production: an API key sent over plain HTTP must be considered leaked. Unknown paths under /api/v1 answer 404 with code not_found.

Authentication#

Create a key in Dashboard → API and send it with every request, either as a bearer token or in X-API-Key:

GET /api/v1/me HTTP/1.1
Host: proxuno.com
Authorization: Bearer pxl_live_7Gq2Xk9Rm4Tn8Vw1Zc5Hb3Jd6Lf0Ps2A

Details, key rotation and storage advice: Authentication.

Conventions#

Endpoints#

Reference pages: Proxies, usage & orders · Residential endpoints & countries · Errors & rate limits.

Rate limits#

Each API key may send 60 requests per minute. Every response carries:

Over the limit, the API answers 429 with code rate_limited and a Retry-After header. Mobile rotation has its own 10-second cooldown per proxy on top of this — see Errors & rate limits.

A first call#

curl -s https://proxuno.com/api/v1/me -H "Authorization: Bearer $PROXUNO_API_KEY"

import os, httpx

client = httpx.Client(
    base_url="https://proxuno.com/api/v1",
    headers={"Authorization": f"Bearer {os.environ['PROXUNO_API_KEY']}"},
    timeout=30,
)
print(client.get("/me").json())

const api = (path, init = {}) =>
  fetch(`https://proxuno.com/api/v1${path}`, {
    ...init,
    headers: { Authorization: `Bearer ${process.env.PROXUNO_API_KEY}`, ...init.headers },
  }).then(async (r) => {
    const body = await r.json();
    if (!r.ok) throw Object.assign(new Error(body.error.message), { code: body.error.code, status: r.status });
    return body;
  });

console.log(await api("/me"));

<?php
$ch = curl_init("https://proxuno.com/api/v1/me");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("PROXUNO_API_KEY")],
]);
$me = json_decode(curl_exec($ch), true);
print_r($me);

Response:

{
  "data": {
    "id": 3187,
    "email": "[email protected]",
    "name": null,
    "locale": "en",
    "email_verified": true,
    "created_at": "2025-11-04T09:12:44.000Z",
    "balance": { "cents": 7550, "currency": "USD" },
    "proxy_auth_mode": "userpass",
    "proxies": { "mobile_active": 3, "static_active": 5, "expiring_soon": 1 },
    "residential": {
      "login": "px4k2m9q7a",
      "host": "resi.gw.proxuno.com",
      "ports": { "http": 7000, "socks5": 7001 },
      "bytes_total": 25000000000,
      "bytes_used": 10180000000,
      "bytes_remaining": 14820000000,
      "active_packages": 1,
      "next_expiry": "2026-11-28T10:41:07.000Z"
    }
  }
}

GET /me does not include the residential password; it is embedded in the lines (or in the password field with format=json) returned by GET /residential/endpoints. Regenerate it from Dashboard → Residential if it leaks.

Changes to v1#

Additions are listed in the changelog under the API tag. The most recent: extended residential endpoint generation (format, protocol, count up to 1,000) in v5.4.2, September 2026.

Public catalogue feed#

The public pricing feed lists current USD prices by mobile country and duration, residential traffic tier and static ISP quantity bracket. It also gives the catalogue date, crypto options and balance top-up limits; it requires no API key.

Use the HTML price list or its Markdown representation to read the same prices with their purchase and refund conditions.