API & resellers

Mobile Proxy API and Reseller Program

Everything you can do in the GlobalProxies dashboard you can also do over a REST API: list live stock by city, carrier and tier, buy lines, extend them, move them between metros for free, rotate and reboot them, read their health, and get a signed webhook the moment one goes down. The same API is what our resellers and agencies run their own storefronts and client fleets on. This page is the overview: what the API covers, how authentication and limits work, and what the reseller program adds on top. The full reference, with every field and error, sits in your dashboard under API Key.

Authentication, base URL and limits

Create a key under API Key in your dashboard and send it on every request in the x-api-key header. All endpoints live under one base URL and accept JSON or form-encoded bodies. A key belongs to one account and spends that account's balance, so treat it like a password and rotate it if it ever leaves your servers.

Each account gets 300 API requests per minute. Endpoints that spend money have their own tighter budgets on top: 20 purchases and 60 extensions per minute. Going over returns 429 with a Retry-After header in seconds; wait that long rather than retrying in a tight loop.

curl https://login.globalproxies.net/backend/api_v1/account/getbalance \
  -H 'x-api-key: YOUR_API_KEY'

Stock and buying

The buy flow endpoints walk the same tree as the Buy page, country to carrier to city to plan, and every count they return is what you can buy right now. Where a city is sold out they also return the next time a port there is due to free up, so your own storefront can say when instead of just no. A quote endpoint prices a selection before you commit.

A purchase names the country, carrier and city, the plan length (DAY, WEEK or MONTH), the tier (4G or 5G) and a quantity. You can fix the proxy username and password yourself or whitelist an IP instead. The response hands back ready-to-use HTTP and SOCKS5 connection strings, a status link and a change-IP link for each line.

GET /proxies lists live stock with capability filters (SOCKS5 UDP, IPv6, phone hardware and more).
POST /proxy/purchase buys one or many lines from your balance.
POST /proxy/quote prices a selection, including out-of-stock locations.
POST /package/upcoming-restock lists the next times a port frees up in a location.

curl -X POST https://login.globalproxies.net/backend/api_v1/proxy/purchase \
  -H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"country":"United States","isp":"AT&T","city":"5G Houston","planType":"MONTH","quantity":2}'

Running the lines you own

GET /proxies/my returns every line on the account with its connection strings, carrier, city and tier as separate fields, its rotation link and its expiry. From there the lifecycle calls are one request each: extend a license by a day, week or month, switch auto-extend on so it renews from balance, move a line to another metro (free, and it keeps its credentials), rotate or reboot it, change its username and password or IP whitelist, set its automatic rotation interval, and tag it with your own labels.

Health endpoints tell you whether a line is up, its recent IP history and its busy-hours speed pattern, and a report-a-problem call opens a ticket on a specific line straight from your own tooling.

Webhooks

Give the account a webhook URL and we POST a signed JSON event when something happens: a line goes down or comes back, a rotation completes or fails, a license is about to expire, has expired or was renewed, or a payment lands on your balance. Every delivery carries X-GP-Event, X-GP-Timestamp and an X-GP-Signature header, an HMAC-SHA256 of the timestamp and raw body with your secret, so you can verify it came from us. Anything other than a 2xx is retried with backoff for a day before the delivery is marked failed.

expected = hmac_sha256(secret, timestamp + "." + raw_body)
assert header["X-GP-Signature"] == "sha256=" + expected

Reservations for sold-out metros

When the city a client wants is full, place a reservation instead of polling. A purchase reservation holds your place in that location's line and buys the line from your balance the minute a port frees, and no walk-in buyer can take a port a confirmed reservation is waiting for. Move and replace reservations do the same for a line you already own, at no charge. Each reservation reports its position, how many ports are promised ahead of it and an estimated time, and takes a free-text note so you can record which of your customers it is for.

The reseller program

GlobalProxies is the only place we offer reseller and wholesale terms. Resellers, agencies and platforms that buy in volume get reseller pricing set on their account, and everything above is built so they can put our lines under their own name.

Save a custom rotation domain and every rotation link your customers see uses your domain, never ours; reseller API responses never fall back to the platform domain. Tag each line with the client it belongs to, note reservations per client, and hand out prepaid gift codes that your customers redeem for balance. Large top-ups can be paid by bank wire or Zelle as well as card, PayPal and crypto, and a PayPal or card auto top-up keeps the balance funded so auto-extend never lapses.

Reseller pricing on your account, agreed with us up front.
Custom rotation domain: white-label rotation links.
Per-line tags and per-reservation notes to map lines to your clients.
Gift codes you can sell or give to your own customers.
Webhooks and a 300 requests per minute API budget for your own panel.
Card, PayPal, crypto (Bitcoin, USDT, Ethereum), Zelle and bank wire top-ups.

How to apply

Open an account, then email support@globalproxies.net or message our Telegram support bot with roughly how many lines you expect to run, which metros and carriers, and whether you resell or use them in-house. We confirm reseller pricing on your account before you commit. You can start building against the API before that; nothing changes in the integration when your pricing switches over.

API and reseller questions

Do I need a separate account to use the API?

No. The API uses the same account, balance and lines as the dashboard. Create a key under API Key and every call acts on that account.

Can my customers see GlobalProxies anywhere?

Not in rotation links once you save a custom rotation domain, and reseller responses never fall back to our domain. The proxy hostnames are ours, so pick the IP form of the host (the API returns both) if you prefer not to show a hostname.

Is there a minimum volume for reseller pricing?

There is no fixed threshold on the page because it depends on the metros, carriers and plan lengths you run. Tell us what you expect to buy and we will confirm the pricing on your account before you commit.

What happens when a city is sold out?

The buy flow tells you when the next port there is due to free up, and a purchase reservation will buy it for you from your balance the moment it does. Moves and replacements can be reserved the same way at no charge.

How do I know a line went down?

Subscribe to the proxy.down and proxy.restored webhook events, or poll the health endpoint. Webhooks are signed with your secret and retried with backoff if your endpoint does not answer.