T-Proxy Reseller API v1

Returns your balance and reseller status.

{ "email": "you@example.com", "balance": 42.50, "is_reseller": true }

Lists every UK fixed-term plan and its price at your account's tier (reseller pricing is applied automatically). Pay & Go is discontinued and never appears here.

{
  "plans": [
    { "code": "4g_day", "label": "4G — 1 day", "generation": "4g", "term": "day", "price_amount": 2.5, "price_unit": "/day" },
    { "code": "5g_month", "label": "5G — 1 month", "generation": "5g", "term": "month", "price_amount": 50, "price_unit": "/month" }
  ]
}

Live availability per carrier. Counts reflect modems free right now — they change constantly and aren't reserved by checking them.

{
  "carriers": [
    { "carrier": "EE", "available_4g": 0, "available_5g": 1, "has_ipv6": true, "has_vless": true, "has_wireguard": true, "has_phone": true, "has_router": true,
      "next_available_4g": "2026-10-05T21:30:00.000Z", "next_available_5g": null,
      "pending": [ { "generation": "4g", "device": "router", "ipv6": true, "vless": true, "wireguard": true, "available_at": "2026-10-05T21:30:00.000Z" } ] }
  ]
}

Carriers: EE, O2, Three, Sky, Lyca.

Query parameters (all optional)

Example: GET /api/v1/stock?wireguard=1&device=router. Filters narrow available_4g, available_5g, next_available_* and pending — the same as the filter chips on the Browse page. The has_* fields always describe what the carrier can do at all, whatever the filters.

next_available_4g / next_available_5g are the earliest time (ISO, UTC) a currently rented proxy of that generation is due to free up, or null when none is scheduled — the same estimate as the "until next slot" countdown on the Browse page. pending lists every rented proxy for the carrier, soonest first, each with its device, IPv6, VLESS and WireGuard flags. These are estimates: a proxy that is extended or auto-renews before then won't free up.

Previews a coupon's discount without using it. Coupons are applied by passing couponCode to POST /proxies or POST /proxies/:id/extend; a coupon is only used up when that order goes through.

Body

{ "valid": true, "code": "BETA25", "discount_type": "percent", "discount_value": 25, "order_total": 40, "discount_amount": 10, "final_amount": 30 }

An invalid, expired or used-up code returns 400 with { "valid": false, "error": "..." }. Prices are your own account's prices, and the discount comes off the whole order.

Trial coupons (discount_type: "trial") make a new order free, but each proxy in it runs for 2 hours, whatever the plan's term. They can't be used on extensions.

Buys one or more proxies on a given carrier and plan. Charges your account balance immediately; fails with 402 if your balance is too low.

Body

curl -X POST https://t-proxy.net/api/v1/proxies \
  -H "x-api-key: tpk_live_..." -H "Content-Type: application/json" \
  -d '{"carrier":"EE","planCode":"4g_week","quantity":2}'

Returns 201 with { "proxies": [...], "charged": 30, "discount_amount": 10, "coupon": "BETA25" } (coupon is null without one). For the proxy shape, see proxy detail. If stock runs out mid-order, whatever was already claimed is rolled back and you're charged nothing; retry with a smaller quantity.

Lists every active proxy on your account.

{ "proxies": [ { "id": 501, "plan": "4g_week", "carrier": "EE", "proxy_username": "...", "proxy_password": "...", "http_port": 8123, "socks_port": 5123, "connect_host": "203.0.113.10", "rotation_url": "https://...", "vless_link": "vless://…", "wireguard_link": "wireguard://…", "ovpn_link": "https://t-proxy.net/api/proxies/public/ovpn/…", "auto_renew": false, "expires_at": "2026-09-24T12:00:00.000Z", "created_at": "2026-09-17 10:00:00" } ] }

vless_link and wireguard_link are null on proxies whose modem doesn't support them. See WireGuard & Vless for how to get them and turn wireguard_link into a config file.

ovpn_link is a shareable OpenVPN profile download that needs no login, so you can pass it straight to your own customer. Anyone with the link can download the profile; the proxy's username and password are still needed to connect.

Same shape as above, plus live fields fetched from the UK database on each call:

{ "proxy": { ...as above,
  "current_ip": { "ipv4": "203.0.113.55", "ipv6": null },
  "spoof": { "current": "", "options": [ { "value": "", "label": "No spoofing (default)" }, { "value": "windows:1", "label": "Windows 10" }, ... ] },
  "ip_mode": { "current": "v4", "ipv6Available": true },
  "data_quota_mb": null,
  "data_usage_mb": 20377.6 } }

data_usage_mb is total traffic (download + upload) since the proxy was created. data_quota_mb is null on all fixed-term plans, which have no data cap. rotation_url is refreshed here too, so use the value from this call if yours stops working. Any live field is null (or its default) if the UK database is briefly unreachable.

Requests a new IP on the modem. Returns { "ok": true, "ext_ip": "203.0.113.99" }.

Reboots the physical device. Returns { "ok": true, "message": "..." }. Expect the proxy to be briefly unreachable afterward.

Extends a proxy's expiry by charging for another term. Body: { "planCode": "4g_week", "couponCode": "BETA25" } (couponCode optional) — planCode must match the proxy's current generation (4G proxies can only extend onto 4G plans, same for 5G).

{ "ok": true, "expires_at": "2026-10-01T12:00:00.000Z", "charged": 15, "discount_amount": 5, "coupon": "BETA25", "plan": "4g_week" }

Downloads the proxy's OpenVPN profile (Content-Type: application/x-openvpn-profile). Same file as ovpn_link, but behind your API key.

Sets the OS / TCP fingerprint the proxy presents. Body: { "os": "windows:1" }, using a value from spoof.options on proxy detail; "" turns spoofing off. os is required.

The profile applies to IPv4 connections to ports 80, 443 and 8443; IPv6 connections and other ports keep the device's own fingerprint. If the spoofed fingerprint matters, set the proxy to prefer IPv4 with POST /proxies/:id/ip-mode and { "mode": "v4" } — otherwise sites that support IPv6 are reached over IPv6 and see the unspoofed fingerprint.

{ "ok": true, "os": "windows:1", "rotation_url": "https://..." }

Chooses whether the proxy prefers IPv4 or IPv6. Body: { "mode": "v4" } or { "mode": "v6" }. Both stay reachable; this only sets the default. "v6" returns 409 if ip_mode.ipv6Available is false, or if the SIM has no IPv6 right now.

{ "ok": true, "mode": "v6", "rotation_url": "https://..." }

Sets your own username or password for HTTP, SOCKS5 and OpenVPN. Body: { "field": "password", "value": "MyPass_123" }, where field is "username" or "password" and value is 3–32 letters, numbers, _ or -. Anything connected with the old login is disconnected.

{ "ok": true, "proxy_username": "...", "proxy_password": "MyPass_123", "rotation_url": "https://..." }

The rotation URL can change when credentials change. Replace your stored copy with the one returned here.

Turns automatic renewal on or off. Body: { "enabled": true }. When on, the proxy is renewed for another term of its current plan from your balance shortly before it expires.

{ "ok": true, "auto_renew": true }